Jest手动模拟node:协议导入模块的Windows兼容文件名方案咨询

问题背景 #

在TypeScript项目中使用Jest手动模拟通过node:协议导入的Node.js内置模块时，创建__mocks__/node:fs.ts并调用jest.mock("node:fs")可以实现模拟，但Windows系统不支持带冒号的文件名。需要找到兼容的替代方案，且无需手动指定mock文件路径，仅调用jest.mock("node:fs")就能生效。

可行的兼容方案 #

方案1：配置Jest模块映射（推荐） #

在jest.config.js或jest.config.ts中添加moduleNameMapper配置，将node:开头的模块导入映射到合法路径的mock文件：

module.exports = {
  // 其他Jest配置项...
  moduleNameMapper: {
    '^node:(fs)$': '<rootDir>/__mocks__/node/$1.ts',
    // 如需模拟其他node:协议模块，按此格式扩展
    // '^node:(path)$': '<rootDir>/__mocks__/node/$1.ts',
  },
};

之后将mock文件放在__mocks__/node/fs.ts，调用jest.mock("node:fs")时，Jest会自动通过映射找到对应的mock文件，同时Windows系统能正常识别该路径。

方案2：内联mock工厂函数 #

如果不想修改Jest配置，可在测试文件中直接编写mock逻辑，无需单独创建mock文件：

jest.mock('node:fs', () => ({
  // 自定义你的mock实现，示例：
  readFileSync: jest.fn().mockReturnValue('模拟文件内容'),
  writeFileSync: jest.fn(),
}));

这种方式适合单个测试文件的简单mock场景，若多个测试需要复用mock逻辑，优先选择方案1。

之前尝试无效的原因 #

• 直接将mock文件放在__mocks__/node/fs.ts时，Jest的手动mock匹配规则是严格对应模块名的，node:fs和node/fs会被识别为两个不同的模块，因此无法自动关联。
• 手动指定mock文件路径的方式虽能生效，但需要维护相对路径，项目结构变动时容易出错，不够灵活。

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