SuperAPI AI 工具集

hono

编程与开发

查看项目

更新于 10-16 05:06

技能介绍

用途:Hono 是轻量、快速的 Web 框架,适合构建 API 与服务端应用,Hono 4.x 在 Node.js、Bun、Deno、Cloudflare Workers 上提供一致的 API。安装:pnpm add hono。

主要能力:支持 app.get/post/put/delete 等 HTTP 方法路由、路径参数、通配符与正则约束;可用 new Hono() 创建子路由并通过 app.route() 挂载实现版本分组;提供 c.json、c.text、c.html、c.redirect、c.notFound 等响应方式;内置 logger、cors、secureHeaders、prettyJSON 等中间件,也可自定义中间件并通过 c.set/c.get 在上下文传递数据。

校验与类型:结合 Zod 与 @hono/zod-validator(pnpm add zod @hono/zod-validator)对 json、param 等做校验,通过 c.req.valid() 获取类型安全数据;可用 Hono<Env> 定义上下文变量类型;通过导出 AppType 与 hono/client 的 hc 实现 RPC 类型安全调用。

错误处理与测试:使用 HTTPException 与 app.onError、app.notFound 统一处理错误;测试可直接调用 app.request(),无需启动服务器,示例使用 vitest。

运行时适配:Node.js 用 @hono/node-server 的 serve;Bun 导出 { port, fetch };Cloudflare Workers 直接导出 app。

限制与注意:资料未提供收费、价格与平台支持范围等细节;需注意中间件要在路由前注册、必须 await next()、CORS 建议全局配置、避免重复解析请求体、校验路径参数、生产环境不要使用宽松 CORS。