如何在Jest中为Cloudflare Worker实例化FetchEvent完成测试

无需额外依赖的FetchEvent模拟方案 #

有两种完全依赖Cloudflare Workers官方生态能力的实现方式，不需要引入node-fetch等额外第三方库：

方案1：手动构造符合接口的模拟对象（适配所有Node.js侧测试环境） #

Cloudflare Workers的FetchEvent在TypeScript中是结构类型匹配，不需要实例化原生类，只要构造的对象包含核心字段即可正常使用：

1. 提前安装@cloudflare/workers-types作为开发依赖（该包为Workers官方类型定义，不属于额外业务依赖）
2. 按照如下代码构造模拟实例：

// 先构造你需要的Request实例
const mockRequest = new Request('https://your-test-domain.com/path', {
  method: 'GET',
  headers: { 'X-Test-Header': 'test' }
});

// 包装为符合FetchEvent接口的模拟对象
const mockFetchEvent = {
  request: mockRequest,
  // 模拟两个核心方法，可根据你的测试需求加断言逻辑
  respondWith: jest.fn(), // 用vitest就写vi.fn()
  waitUntil: jest.fn()
} as unknown as FetchEvent;

直接将该对象传入handleRequest方法即可正常运行测试，类型校验也能完全通过。

方案2：基于Wrangler内置测试环境直接实例化原生对象 #

如果使用Wrangler 2+内置的测试能力（基于workerd runtime运行测试），运行环境原生支持FetchEvent构造函数，直接实例化即可：

const mockRequest = new Request('https://your-test-domain.com/path');
// 直接调用原生构造函数生成真实FetchEvent实例
const mockFetchEvent = new FetchEvent('fetch', { request: mockRequest });

该方案得到的是完全和生产环境一致的原生实例，不需要任何手动模拟字段。

内容的提问来源于stack exchange，提问作者Luke Carr