Hono

Hono - 在日语中意为火焰🔥 - 是一个基于 Web 标准构建的小型、简单且超快的 Web 框架。 它适用于任何 JavaScript 运行时：Cloudflare Workers、Fastly Compute、Deno、Bun、Vercel、Netlify、AWS Lambda、Lambda@Edge 和 Node.js。

快，但不止于快。

import { Hono } from 'hono'
const app = new Hono()

app.get('/', (c) => c.text('Hono!'))

export default app

快速入门

只需运行：

npm

npm create hono@latest

yarn

yarn create hono

pnpm

pnpm create hono@latest

bun

bun create hono@latest

deno

deno init --npm hono@latest

特性

• 超快 🚀 - 路由器 RegExpRouter 速度极快。不使用线性循环。就是快。
• 轻量 🪶 - hono/tiny 预设大小不到 14kB。Hono 零依赖，仅使用 Web 标准。
• 多运行时 🌍 - 适用于 Cloudflare Workers、Fastly Compute、Deno、Bun、AWS Lambda 或 Node.js。同一套代码可在所有平台运行。
• 开箱即用 🔋 - Hono 内置中间件、自定义中间件、第三方中间件和辅助函数。开箱即用。
• 愉悦的开发体验 😃 - 超级简洁的 API。一流的 TypeScript 支持。现在，我们有了“类型”。

用例

Hono 是一个类似于 Express 的简单 Web 应用程序框架，不包含前端。 但它在 CDN 边缘运行，并允许您通过结合中间件构建更大型的应用程序。 以下是一些用例示例。

• 构建 Web API
• 后端服务器代理
• CDN 前端
• 边缘应用
• 库的基础服务器
• 全栈应用

谁在使用 Hono？

项目	平台	用途
cdnjs	Cloudflare Workers	一个免费和开源的 CDN 服务。 Hono 用于 API 服务器。
Cloudflare D1	Cloudflare Workers	无服务器 SQL 数据库。 Hono 用于内部 API 服务器。
Cloudflare Workers KV	Cloudflare Workers	无服务器键值数据库。 Hono 用于内部 API 服务器。
BaseAI	本地 AI 服务器	带有内存的无服务器 AI 代理管道。一个用于 Web 的开源代理 AI 框架。 使用 Hono 的 API 服务器。
Unkey	Cloudflare Workers	一个开源的 API 认证和授权。 Hono 用于 API 服务器。
OpenStatus	Bun	一个开源的网站和 API 监控平台。 Hono 用于 API 服务器。
Deno Benchmarks	Deno	一个基于 V8 构建的安全 TypeScript 运行时。 Hono 用于基准测试。
Clerk	Cloudflare Workers	一个开源的用户管理平台。 Hono 用于 API 服务器。

以及以下项目。

• Drivly - Cloudflare Workers
• repeat.dev - Cloudflare Workers

想看更多？请参阅 谁在生产环境中使用 Hono？。

1 分钟了解 Hono

演示如何使用 Hono 为 Cloudflare Workers 创建应用程序。

超快

Hono 是最快的，与 Cloudflare Workers 的其他路由器相比。

Hono x 402,820 ops/sec ±4.78% (80 runs sampled)
itty-router x 212,598 ops/sec ±3.11% (87 runs sampled)
sunder x 297,036 ops/sec ±4.76% (77 runs sampled)
worktop x 197,345 ops/sec ±2.40% (88 runs sampled)
最快的是 Hono
✨  完成于 28.06s。

查看 更多基准测试。

轻量

Hono 非常小。使用 hono/tiny 预设，其压缩后的大小小于 14KB。虽然有许多中间件和适配器，但它们仅在使用时才会被打包。作为对比，Express 的大小为 572KB。

$ npx wrangler dev --minify ./src/index.ts
 ⛅️ wrangler 2.20.0
--------------------
⬣ 监听于 http://0.0.0.0:8787
- http://127.0.0.1:8787
- http://192.168.128.165:8787
总上传大小: 11.47 KiB / gzip: 4.34 KiB

多种路由器

Hono 有多种路由器。

RegExpRouter 是 JavaScript 世界中最快的路由器。它使用在分发前创建的单个大型正则表达式来匹配路由。配合 SmartRouter，它支持所有路由模式。

LinearRouter 注册路由的速度非常快，因此适用于每次都初始化应用程序的环境。PatternRouter 只是简单地添加和匹配模式，使其体积很小。

查看 更多关于路由的信息。

Web 标准

得益于Web 标准的使用，Hono 可以在许多平台上运行。

• Cloudflare Workers
• Cloudflare Pages
• Fastly Compute
• Deno
• Bun
• Vercel
• AWS Lambda
• Lambda@Edge
• 其他

通过使用 Node.js 适配器，Hono 也可以在 Node.js 上运行。

查看 更多关于 Web 标准的信息。

中间件和辅助函数

Hono 有许多中间件和辅助函数。这使得“写得更少，做得更多”成为现实。

开箱即用，Hono 提供了以下中间件和辅助函数：

• 基本认证
• 承载认证
• 请求体限制
• 缓存
• 压缩
• 上下文存储
• Cookie
• CORS
• ETag
• html
• JSX
• JWT 认证
• 日志
• 语言
• 美化 JSON
• 安全头
• SSG
• 流式传输
• GraphQL 服务器
• Firebase 认证
• Sentry
• 其他！

例如，使用 Hono 添加 ETag 和请求日志只需几行代码：

import { Hono } from 'hono'
import { etag } from 'hono/etag'
import { logger } from 'hono/logger'

const app = new Hono()
app.use(etag(), logger())

查看 更多关于中间件的信息。

开发者体验

Hono 提供了愉悦的“开发者体验”。

通过 Context 对象可以轻松访问请求/响应。 此外，Hono 是用 TypeScript 编写的。Hono 拥有“类型”。

例如，路径参数将是字面量类型。

而且，Validator 和 Hono 客户端 hc 启用了 RPC 模式。在 RPC 模式下， 您可以使用您喜欢的验证器（如 Zod），并轻松地与客户端共享服务器端的 API 规范，从而构建类型安全的应用程序。

查看 Hono 技术栈。