Cloudflare Testing
你可以通过 @cloudflare/vitest-pool-workers
轻松实现 Cloudflare 测试。这需要预先进行一些配置,详细信息可以在 Cloudflare 测试文档 中找到。
Cloudflare 使用 vitest pool workers 进行测试时,会在运行时提供 cloudflare:test
模块,该模块会暴露在测试期间作为第二个参数传入的环境变量。更多相关信息请参考 Cloudflare 测试 API 章节。
以下是配置示例:
ts
import { defineWorkersProject } from '@cloudflare/vitest-pool-workers/config'
export default defineWorkersProject(() => {
return {
test: {
globals: true,
poolOptions: {
workers: { wrangler: { configPath: './wrangler.toml' } },
},
},
}
})
toml
compatibility_date = "2024-09-09"
compatibility_flags = [ "nodejs_compat" ]
[vars]
MY_VAR = "my variable"
假设有如下应用:
ts
// src/index.ts
import { Hono } from 'hono'
type Bindings = {
MY_VAR: string
}
const app = new Hono<{ Bindings: Bindings }>()
app.get('/hello', (c) => {
return c.json({ hello: 'world', var: c.env.MY_VAR })
})
export default app
你可以通过将 cloudflare:test
模块暴露的 env
传递给 app.request()
来测试带有 Cloudflare Bindings 的应用:
ts
// src/index.test.ts
import { env } from 'cloudflare:test'
import app from './index'
describe('Example', () => {
it('Should return 200 response', async () => {
const res = await app.request('/hello', {}, env)
expect(res.status).toBe(200)
expect(await res.json()).toEqual({
hello: 'world',
var: 'my variable',
})
})
})
另请参阅
@cloudflare/vitest-pool-workers
GitHub 仓库示例
从旧测试系统迁移