更多工具

更多 H3 实用工具。

基础

withBase(base, input)

返回一个新的事件处理器,该处理器在调用原始处理器之前会移除事件的基础 URL。

示例:

const api = new H3()
 .get("/", () => "Hello API!");
const app = new H3();
 .use("/api/**", withBase("/api", api.handler));

事件

isEvent(input)

检查输入是否为 H3Event 对象。

mockEvent(_request, options?)

中间件

onError(hook)

定义一个错误发生时运行的中间件。

You can return a new Response from the handler to gracefully handle the error.

onRequest(hook)

定义一个在每次请求时运行的中间件。

onResponse(hook)

定义一个在响应生成后运行的中间件。

You can return a new Response from the handler to replace the original response.

WebSocket

defineWebSocket(hooks)

定义 WebSocket 钩子。

defineWebSocketHandler(hooks)

定义 WebSocket 事件处理器。

适配器

defineNodeHandler(handler)

defineNodeMiddleware(handler)

fromNodeHandler(handler)

fromWebHandler()

toNodeHandler(app)

将 H3 应用实例转换为具有 (IncomingMessage, ServerResponse) => void 签名的 NodeHandler。