能否使用Jest测试基于AbortSignal.timeout的fetch超时行为？

环境版本 #

• node: 20.15.1
• jest: 29.7.0
• jest-environment-jsdom: 29.7.0

待测试代码 #

const response = await fetch(url, { signal: AbortSignal.timeout(5000) });

问题描述 #

我希望使用Jest对上述JavaScript代码进行单元测试，重点验证其超时行为，但这是否真的可行？

无论我如何操作，都必须mock fetch函数。虽然我可以让它触发拒绝或超时等行为，但本质上只是在测试mock的功能。

我感觉这部分逻辑属于Web API的范畴，是不是无法进行单元测试？

解答 #

首先要明确单元测试的核心边界：单元测试只需要验证你的代码逻辑，而非Web API本身的实现正确性（比如AbortSignal.timeout与fetch的交互逻辑，是浏览器/Node.js官方需要保证的，不需要你重复测试）。基于这个边界，你完全可以通过合理的mock来完成有效测试：

1. 验证参数传递的正确性
   你可以mock fetch，然后断言调用fetch时是否正确传入了signal参数，且该参数是AbortSignal.timeout(5000)生成的实例。比如：

   jest.spyOn(global, 'fetch');
   await yourFunctionThatCallsFetch();
   expect(fetch).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
     signal: expect.any(AbortSignal)
   }));
   // 进一步验证超时时间
   expect(fetch.mock.calls[0][1].signal.timeout).toBe(5000);
   

   这一步测试的是你的代码是否正确配置了超时信号，属于你的代码逻辑范畴。

2. 验证超时场景下的错误处理逻辑
   如果你需要测试当fetch因超时被中止时，你的代码如何处理错误，你可以让mock的fetch抛出符合规范的AbortError，然后断言你的错误处理逻辑是否执行。比如：

   jest.spyOn(global, 'fetch').mockRejectedValue(new DOMException('The operation was aborted.', 'AbortError'));
   await expect(yourFunctionThatCallsFetch()).rejects.toThrow(DOMException);
   await expect(yourFunctionThatCallsFetch()).rejects.toThrow('AbortError');
   

   这一步测试的是你的代码对超时错误的处理逻辑，而非mock本身的功能——mock只是模拟了Web API会抛出的错误场景，你要验证的是自己的代码在该场景下的表现。

3. 关于真实超时场景的测试
   如果你一定要测试「真实的超时触发fetch中止」，这已经超出了单元测试的范畴，属于集成测试。此时你可以借助工具模拟网络延迟（比如用nock拦截请求并延迟响应），或者在Node.js环境中利用undici（Node的fetch基于它）的特性来测试，但这类测试更依赖环境，不属于单元测试的核心目标。

综上，通过mock进行单元测试是完全可行且合理的，你不需要测试Web API的实现，只需要确保你的代码正确使用API并处理对应场景即可。

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