Bun

Bun 是另一个 JavaScript 运行时。它不是 Node.js 或 Deno。Bun 内置了转译编译器，我们可以使用 TypeScript 编写代码。 Hono 也可以在 Bun 上运行。

1. 安装 Bun

要安装 bun 命令，请按照 官方网站 上的说明进行操作。

2. 设置

2.1. 设置新项目

Bun 提供了一个启动器。使用 "bun create" 命令启动你的项目。 在这个例子中选择 bun 模板。

bun create hono@latest my-app

移动到 my-app 目录并安装依赖。

cd my-app
bun install

2.2. 设置现有项目

在现有的 Bun 项目中，我们只需要在项目根目录通过以下命令安装 hono 依赖：

bun add hono

3. Hello World

"Hello World" 脚本如下所示。与在其他平台上编写几乎相同。

import { Hono } from 'hono'

const app = new Hono()
app.get('/', (c) => c.text('Hello Bun!'))

export default app

4. 运行

运行以下命令。

bun run dev

然后在浏览器中访问 http://localhost:3000。

更改端口号

你可以通过导出 port 来指定端口号。

import { Hono } from 'hono'

const app = new Hono()
app.get('/', (c) => c.text('Hello Bun!'))

export default app 
export default { 
  port: 3000, 
  fetch: app.fetch, 
} 

提供静态文件

要提供静态文件，请使用从 hono/bun 导入的 serveStatic。

import { serveStatic } from 'hono/bun'

const app = new Hono()

app.use('/static/*', serveStatic({ root: './' }))
app.use('/favicon.ico', serveStatic({ path: './favicon.ico' }))
app.get('/', (c) => c.text('You can access: /static/hello.txt'))
app.get('*', serveStatic({ path: './static/fallback.txt' }))

对于上面的代码，它将与以下目录结构良好地配合工作。

./
├── favicon.ico
├── src
└── static
    ├── demo
    │   └── index.html
    ├── fallback.txt
    ├── hello.txt
    └── images
        └── dinotocat.png

rewriteRequestPath

如果你想将 http://localhost:3000/static/* 映射到 ./statics，你可以使用 rewriteRequestPath 选项：

app.get(
  '/static/*',
  serveStatic({
    root: './',
    rewriteRequestPath: (path) =>
      path.replace(/^\/static/, '/statics'),
  })
)

mimes

你可以使用 mimes 添加 MIME 类型：

app.get(
  '/static/*',
  serveStatic({
    mimes: {
      m3u8: 'application/vnd.apple.mpegurl',
      ts: 'video/mp2t',
    },
  })
)

onFound

你可以使用 onFound 指定当请求的文件被找到时的处理方式：

app.get(
  '/static/*',
  serveStatic({
    // ...
    onFound: (_path, c) => {
      c.header('Cache-Control', `public, immutable, max-age=31536000`)
    },
  })
)

onNotFound

你可以使用 onNotFound 指定当请求的文件未找到时的处理方式：

app.get(
  '/static/*',
  serveStatic({
    onNotFound: (path, c) => {
      console.log(`${path} is not found, you access ${c.req.path}`)
    },
  })
)

precompressed

precompressed 选项会检查是否提供了带有 .br 或 .gz 等扩展名的文件，并根据 Accept-Encoding 标头提供它们。它优先考虑 Brotli，然后是 Zstd 和 Gzip。 如果都没有，则提供原始文件。

app.get(
  '/static/*',
  serveStatic({
    precompressed: true,
  })
)

测试

你可以在 Bun 上使用 bun:test 进行测试。

import { describe, expect, it } from 'bun:test'
import app from '.'

describe('My first test', () => {
  it('Should return 200 Response', async () => {
    const req = new Request('http://localhost/')
    const res = await app.fetch(req)
    expect(res.status).toBe(200)
  })
})

然后，运行以下命令。

bun test index.test.ts