在TypeScript中使用Mocha对ES6模块进行Mock的问题

问题背景 #

在启用type:module的ES6模块项目中，混合了JavaScript和TypeScript文件，使用Mocha+ts-node/esm运行单元测试时，遇到Mock工具的loader冲突问题：

• 用ts-node/esm loader可正常解析TS文件，但无法使用testdouble的Stub/Mock能力；
• 替换为testdouble/esm loader则会出现TS文件找不到的错误：

Error [ERR_MODULE_NOT_FOUND]: Cannot find module
'/Users/repos/my-repo/src/models/connectionModel.js'
imported from
/Users/repos/my-repo/test/constants.tjs
（注：connectionModel是ts文件，按照ESM规范以.js后缀导入）

项目要求必须编译为ES6+，因此无法切换到CommonJS模块系统。

可行解决方案 #

方案1：链式使用多个Node.js Loader #

Node.js支持通过数组形式指定多个loader，执行顺序为从左到右。我们需要让ts-node/esm先处理TS文件解析，再让testdouble/esm处理Mock逻辑。

修改配置文件

更新.mocharc.json的node-option配置：

{
  "node-option": [
    "experimental-specifier-resolution=node",
    "loader=ts-node/esm",
    "loader=testdouble/esm"
  ]
}

注意事项

• 确保testdouble版本≥10.0.0（该版本开始支持ESM loader）；
• 所有TS文件的导入必须遵循ESM规范，使用.js后缀（如import connectionModel from '../src/models/connectionModel.js'）；
• 保持tsconfig.json中的moduleResolution: node16配置，确保TS文件解析正确。

方案2：使用无需额外Loader的Mock工具 #

如果链式loader存在兼容性问题，可改用esmock——一款无需配置loader的ESM Mock工具，直接在测试文件中使用。

安装依赖

npm install esmock --save-dev

在测试文件中使用

import esmock from 'esmock';

// Mock目标模块
const mockedConnectionModel = await esmock('../src/models/connectionModel.js', {}, {
  default: {
    getConnection: () => Promise.resolve({ mockId: 'test-connection' })
  }
});

// 使用Mock后的模块测试
describe('测试示例', () => {
  it('验证Mock方法调用', async () => {
    const conn = await mockedConnectionModel.getConnection();
    assert.equal(conn.mockId, 'test-connection');
  });
});

这种方式无需修改任何loader配置，直接沿用原有的ts-node/esm即可，完全避免loader冲突。

补充配置检查 #

确保现有配置符合以下要求：

• package.json保留type: module；
• tsconfig.json的include包含src和test目录的所有文件；
• mocha脚本保持原有的mocha test/*.js test/*.spec.ts -r dotenv/config即可。

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