TypeScript断言模块单实例异常：Jest测试中断言未正确关闭

问题出在哪？ #

Jest默认会给每个测试文件创建独立的模块上下文，而且可能在测试前重置模块缓存。再加上如果你的测试代码和被测ADT类导入断言工具包的路径不一致（比如一个用./assert，另一个用../utils/assert，或者TypeScript别名配置没对齐），Node.js的模块解析器会把它们当成完全不同的模块，加载两次，自然就出现两个独立的assertionsEnabled变量了。另外，Jest的模块隔离机制也会打破CommonJS/ES模块的单例特性。

具体怎么修？ #

1. 先统一导入路径 #

确保测试代码和被测类用完全一样的路径导入断言工具包：

• 别混合用相对路径和绝对路径
• 用了TypeScript路径别名的话，tsconfig.json和Jest的moduleNameMapper必须配置一致

举个例子：

// 被测ADT类里
import { assert, withAssertions } from '@/utils/assert';

// 测试代码里也得这么写
import { assert, withAssertions } from '@/utils/assert';

2. 关掉Jest的模块重置（按需用） #

如果你的测试不需要严格的模块隔离，可以禁用模块重置：

• 单个测试文件里加：

beforeAll(() => {
  jest.resetModules = jest.fn(); // 直接覆盖重置模块的方法
});

• 全局配置（jest.config.js）：

module.exports = {
  resetModules: false,
};

注意：这么做可能导致测试间的状态污染，得确保你的测试都是无状态的。

3. 把开关变量放到全局对象上 #

既然模块单例被打破，直接把assertionsEnabled挂到全局，确保全项目唯一：
修改断言工具包的代码：

// assert.ts
declare global {
  var assertionsEnabled: boolean;
}

// 初始化全局开关
global.assertionsEnabled = true;

export function assert(condition: boolean, message?: string) {
  if (global.assertionsEnabled && !condition) {
    throw new Error(message || 'Assertion failed');
  }
}

export function withAssertions(enabled: boolean, fn: () => void) {
  const original = global.assertionsEnabled;
  global.assertionsEnabled = enabled;
  try {
    fn();
  } finally {
    // 执行完恢复原来的状态
    global.assertionsEnabled = original;
  }
}

这样不管模块被加载多少次，都共享同一个全局开关。

4. 直接模拟断言工具包的实现 #

在测试里用Jest的mock功能替换掉断言工具的导出，强制控制开关：

// 测试文件中
jest.mock('@/utils/assert', () => {
  let enabled = true;
  return {
    assert: (condition: boolean, message?: string) => {
      if (enabled && !condition) {
        throw new Error(message || 'Assertion failed');
      }
    },
    withAssertions: (isEnabled: boolean, fn: () => void) => {
      const original = enabled;
      enabled = isEnabled;
      try {
        fn();
      } finally {
        enabled = original;
      }
    },
  };
});

这种方式直接绕开了模块加载的问题，完全在测试环境中自定义断言工具的行为。

怎么验证问题？ #

可以在断言工具包顶部加一行日志：

// assert.ts
console.log('Assert module loaded');

如果运行测试时打印了两次，说明模块确实被加载了两次，这时候重点检查导入路径或者Jest的模块配置。

内容的提问来源于stack exchange，提问作者John Tang Boyland