This release is 9 versions behind 4.7.9 — the latest version of @hono/hono. Jump to latest
Built and signed on GitHub ActionsBuilt and signed on GitHub Actions
Built and signed on GitHub Actions
Web framework built on Web Standards
This package works with Cloudflare Workers, Node.js, Deno, Bun, Browsers




JSR Score
76%
Published
4 months ago (4.6.20)
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859/** * @module * Request ID Middleware for Hono. */ import type { Context } from '../../context.ts' import type { MiddlewareHandler } from '../../types.ts' export type RequestIdVariables = { requestId: string } export type RequestIdOptions = { limitLength?: number headerName?: string generator?: (c: Context) => string } /** * Request ID Middleware for Hono. * * @param {object} options - Options for Request ID middleware. * @param {number} [options.limitLength=255] - The maximum length of request id. * @param {string} [options.headerName=X-Request-Id] - The header name used in request id. * @param {generator} [options.generator=() => crypto.randomUUID()] - The request id generation function. * * @returns {MiddlewareHandler} The middleware handler function. * * @example * ```ts * type Variables = RequestIdVariables * const app = new Hono<{Variables: Variables}>() * * app.use(requestId()) * app.get('/', (c) => { * console.log(c.get('requestId')) // Debug * return c.text('Hello World!') * }) * ``` */ export const requestId = ({ limitLength = 255, headerName = 'X-Request-Id', generator = () => crypto.randomUUID(), }: RequestIdOptions = {}): MiddlewareHandler => { return async function requestId(c, next) { // If `headerName` is empty string, req.header will return the object let reqId = headerName ? c.req.header(headerName) : undefined if (!reqId || reqId.length > limitLength || /[^\w\-]/.test(reqId)) { reqId = generator(c) } c.set('requestId', reqId) if (headerName) { c.header(headerName, reqId) } await next() } }