Nock 14 Beta 版本在 JSDOM 环境下的兼容性问题分析

Nock 作为 Node.js 生态中广泛使用的 HTTP 模拟库，在其 14.0.0-beta.8 版本中引入了一个值得开发者注意的兼容性问题。该问题主要影响在 JSDOM 测试环境下使用 Nock 的场景，表现为两种不同的错误情况。

问题现象

当开发者尝试在 JSDOM 环境中使用 Nock 时，会遇到两种典型错误：

1. TextEncoder is not defined 错误：这是由于 JSDOM 环境默认不提供 TextEncoder 全局变量导致的。
2. Cannot find module '@mswjs/interceptors/presets/node' 错误：即使该模块确实存在于 node_modules 中，JSDOM 环境下仍无法正确加载。

问题根源

深入分析后发现，这两个问题都与 Nock 14 beta 版本内部改用 @mswjs/interceptors 作为底层实现有关：

1. @mswjs/interceptors 的浏览器版本实现依赖 TextEncoder，而 JSDOM 环境默认不提供这个 API。
2. 模块解析问题源于 @mswjs/interceptors 的导出配置 - 它只为 Node 环境定义了 presets/node 导出，而没有为浏览器环境提供相应的映射。

解决方案比较

对于需要在 JSDOM 环境中使用 Nock 的开发者，目前有几种可行的解决方案：

1. Jest 环境配置法
   通过修改 Jest 配置的 testEnvironmentOptions，添加自定义导出条件：

module.exports = {
  testEnvironmentOptions: {
    customExportConditions: ['browser', 'node']
  }
}

2. 模块路径映射法
   使用 Jest 的 moduleNameMapper 直接指定模块路径：

module.exports = {
  moduleNameMapper: {
    '@mswjs/interceptors/presets/node': '<path_to_preset>'
  }
}

3. 自定义解析器法
   实现自定义的模块解析逻辑来处理特殊的模块引用情况。

技术背景延伸

Nock 14 的 beta 版本引入 @mswjs/interceptors 是为了统一 HTTP 拦截的实现，并为未来支持浏览器环境做准备。不过目前官方明确表示浏览器支持还不是优先事项。

JSDOM 作为 Node.js 中的浏览器环境模拟器，与真实浏览器环境存在一些差异。开发者需要注意：

• 许多 Web API 需要手动 polyfill
• 模块解析逻辑可能不同于 Node 环境
• 某些 Node.js 特有功能在 JSDOM 中不可用

最佳实践建议

对于需要同时在 Node 和 JSDOM 环境中测试的项目：

1. 明确区分不同环境的测试用例
2. 为 JSDOM 环境准备必要的 polyfill
3. 考虑使用条件导入来处理环境差异
4. 密切关注 Nock 正式版的发布公告

虽然目前可以通过一些配置技巧让 Nock 在 JSDOM 中工作，但开发者应该意识到这并非官方支持的使用场景，未来版本可能会有变化。对于关键项目，建议评估是否真的需要在 JSDOM 环境中使用 HTTP 拦截功能。