测试

测试是很重要的。实际上，测试 Hono 应用程序是很简单的。虽然为不同运行时创建测试环境的方式各不相同，但基本步骤是一样的。在本节中，我们将使用 Cloudflare Workers 和 Jest 进行测试。

请求和响应

你只需要创建一个 Request 对象并将其传递给 Hono 应用程序来验证 Response。而且，你可以使用 app.request 这个实用的方法。

TIP

关于类型化的测试客户端，请参见测试助手。

例如，考虑一个提供以下 REST API 的应用程序。

app.get('/posts', (c) => {
  return c.text('Many posts')
})

app.post('/posts', (c) => {
  return c.json(
    {
      message: 'Created',
    },
    201,
    {
      'X-Custom': 'Thank you',
    }
  )
})

向 GET /posts 发送请求并测试响应。

describe('Example', () => {
  test('GET /posts', async () => {
    const res = await app.request('/posts')
    expect(res.status).toBe(200)
    expect(await res.text()).toBe('Many posts')
  })
})

要向 POST /posts 发送请求，可以这样做：

test('POST /posts', async () => {
  const res = await app.request('/posts', {
    method: 'POST',
  })
  expect(res.status).toBe(201)
  expect(res.headers.get('X-Custom')).toBe('Thank you')
  expect(await res.json()).toEqual({
    message: 'Created',
  })
})

要发送带有 JSON 数据的 POST /posts 请求，可以这样做：

test('POST /posts', async () => {
  const res = await app.request('/posts', {
    method: 'POST',
    body: JSON.stringify({ message: 'hello hono' }),
    headers: new Headers({ 'Content-Type': 'application/json' }),
  })
  expect(res.status).toBe(201)
  expect(res.headers.get('X-Custom')).toBe('Thank you')
  expect(await res.json()).toEqual({
    message: 'Created',
  })
})

要发送带有 multipart/form-data 数据的 POST /posts 请求，可以这样做：

test('POST /posts', async () => {
  const formData = new FormData()
  formData.append('message', 'hello')
  const res = await app.request('/posts', {
    method: 'POST',
    body: formData,
  })
  expect(res.status).toBe(201)
  expect(res.headers.get('X-Custom')).toBe('Thank you')
  expect(await res.json()).toEqual({
    message: 'Created',
  })
})

你也可以传递 Request 类的实例。

test('POST /posts', async () => {
  const req = new Request('http://localhost/posts', {
    method: 'POST',
  })
  const res = await app.request(req)
  expect(res.status).toBe(201)
  expect(res.headers.get('X-Custom')).toBe('Thank you')
  expect(await res.json()).toEqual({
    message: 'Created',
  })
})

通过这种方式，你可以进行类似端到端的测试。

环境变量

要在测试中设置 c.env，你可以将其作为第三个参数传递给 app.request。这对于模拟像 Cloudflare Workers Bindings 这样的值很有用：

const MOCK_ENV = {
  API_HOST: 'example.com',
  DB: {
    prepare: () => {
      /* 模拟 D1 */
    },
  },
}

test('GET /posts', async () => {
  const res = await app.request('/posts', {}, MOCK_ENV)
})

测试 ​

请求和响应 ​

环境变量 ​

测试

请求和响应

环境变量