从CommonJS迁移至ESM后，测试时清除库缓存的方案咨询

问题背景 #

在将web-push库迁移为ESM格式时，遇到测试代码中的状态重置逻辑无法兼容的问题。原CommonJS测试通过清除require.cache来保证每次测试的干净状态，代码如下：

mocha.beforeEach(function() {
  requestBody = null;
  requestDetails = null;

  // Delete caches of web push libs to start clean between test runs
  delete require.cache[path.join(__dirname, '..', 'src', 'index.js')];
  delete require.cache[path.join(__dirname, '..', 'src', 'web-push-lib.js')];
});

核心问题解答 #

1. ESM下如何适配状态重置逻辑？ #

ESM没有官方提供清除模块缓存的API——因为ESM是静态加载、缓存不可变的设计。但可以通过以下几种方式替代：

• 重构模块为可重置结构：把模块内的全局状态改成类实例或可重置的对象，暴露初始化/重置方法。测试时每次调用重置方法，而非重新加载模块。
• 动态导入配合状态重置：在beforeEach中用import()动态导入模块，同时配合模块内部的状态重置方法（引擎仍会缓存模块，所以必须主动重置内部状态）。
• 测试上下文隔离：借助Mocha的测试上下文，每个测试用例维护独立的模块实例，避免跨测试的状态污染。

2. 原方案是常规操作还是hack？ #

这种删除require.cache的方式属于CommonJS生态下的测试hack，并非常规最佳实践。CommonJS的模块缓存暴露是设计特性，但直接修改缓存来重置状态，本质上是绕过了模块的单例设计，属于为了测试便捷而破坏模块正常加载逻辑的权宜之计。标准的测试方案应该是让模块本身具备可测试性（比如依赖注入、状态可重置），而非依赖缓存修改。

3. 最小改动的折中方案 #

如果不想重写整个测试逻辑，可以尝试：

• 给目标模块添加测试专用的重置函数：比如在web-push-lib.js中新增__resetInternalState()方法（仅在测试环境生效），在beforeEach中调用该方法替代删除缓存。
• 移除模块全局状态：把模块内的全局变量改为局部变量，通过导出的方法封装状态，自然避免跨测试的状态污染。

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