Sinon.js 中 Node.js 21.7.0 版本 fetch 方法模拟失效问题解析

问题背景

在 Node.js 21.7.0 版本中，开发者发现无法再使用 Sinon.js 对全局的 fetch 方法进行存根(stub)操作。这个问题在测试场景中尤为关键，因为模拟网络请求是单元测试中的常见需求。

现象描述

当开发者尝试使用 Sinon.js 的 stub 方法来模拟全局 fetch 方法时，代码会抛出异常。具体表现为：

1. 尝试对 globalThis.fetch 进行存根操作
2. 执行 fetch 调用时，不是调用模拟方法，而是尝试发起真实网络请求
3. 由于请求地址不存在，最终抛出 ENOTFOUND 错误

技术分析

这个问题源于 Node.js 21.7.0 版本中对 fetch 实现方式的内部变更。在底层，Node.js 的 fetch 实现变得更加严格，导致传统的存根方法失效。

在 Node.js 21.6.2 及以下版本中，开发者可以正常使用 Sinon.js 对 fetch 进行存根操作。但在 21.7.0 版本中，这种操作会直接失败。

解决方案

目前有以下几种解决方案：

1. 升级 Node.js 版本：Node.js 22.1.0 及以上版本已经修复了这个问题。对于使用 Node.js 20.x 的用户，可以升级到 20.13.1 及以上版本。

2. 临时解决方案：在尝试存根之前，先引用一次 global.fetch，这可以确保 fetch 方法被正确识别。

3. 使用替代测试工具：考虑使用 Node.js 内置的测试模块中的 mock 功能，或者使用其他专门的 HTTP 请求模拟库。

最佳实践建议

1. 在测试环境中，建议使用专门的 HTTP 请求模拟库而非直接存根 fetch 方法。

2. 对于需要模拟 fetch 的场景，可以考虑创建一个包装函数，然后对这个包装函数进行测试，而不是直接模拟全局 fetch。

3. 保持测试框架和 Node.js 版本的同步更新，避免使用已知有问题的版本组合。

总结

这个问题展示了 JavaScript 生态系统中底层 API 变更可能对测试工具链产生的影响。作为开发者，我们需要：

• 关注核心运行时环境的变更日志
• 在升级版本前进行充分的测试验证
• 采用更加健壮的测试策略，减少对全局对象直接操作的依赖

通过理解这些底层机制，我们可以编写出更加可靠和可维护的测试代码。