SuperAPI AI 工具集

hono

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:为 TypeScript API 路由开发提供 Hono 模式参考,覆盖中间件、请求与响应类型、流式传输、WebSocket 以及 Cloudflare Workers 部署。

参考资源:Hono(面向边缘运行时与 Cloudflare Workers 的 TypeScript Web 框架);Cloudflare 文档(Workers、Durable Objects、WebSockets、KV、R2 与部署)。

外部求证:当 Hono 路由类型、中间件顺序、上下文变量、响应助手、流式传输、WebSocket 或 Cloudflare Worker 运行时行为影响正确性时,先向 DeepWiki 就 honojs/hono 或 cloudflare/cloudflare-docs 提出窄问题,再对照本地已安装类型、源码或官方文档验证关键细节后再改代码。稳定的 HTTP 基础与仓库内已有的 API 约定无需查询。

中间件与上下文:中间件为洋葱模型,顺序敏感;资源准备应位于鉴权之前,鉴权应位于受保护路由之前。用 createFactory<Env>() 与 Env['Variables'] 为 c.var、c.set() 提供类型。继续执行的中间件必须 await next();拒绝或重定向的中间件应返回响应并跳过 next()。处理函数应返回 c.json()、c.text()、c.html() 等 Hono 响应助手或 Response。在 Cloudflare Workers 上从 c.env 读取绑定,从 c.executionCtx 读取请求生命周期 API。涉及 Cookie 鉴权或带凭证的跨域前端调用时,应在鉴权路由之前注册 CORS。先用 app.request() 或 testClient 配合模拟绑定与执行上下文测试路由行为,再考虑启动网络服务器。当通用中间件可能修改响应头时,需显式保留 WebSocket 升级检测。

适用场景:在边缘运行时或 Cloudflare Workers 上编写、审查与测试 Hono 后端路由。

限制:资料未提供安装命令、版本要求、收费信息与具体代码示例;实际行为以本地类型、源码或官方文档为准。