单元测试中如何Mock Node.js运行时操作系统以测试Path模块

node:path模块的默认运行逻辑会随Node.js应用运行所在的操作系统不同而存在差异，相同的path.basename调用在POSIX和Windows系统下的返回结果存在明显差异：

// On POSIX:
path.basename('C:\\temp\\myfile.html');
// Returns: 'C:\\temp\\myfile.html'

//On Windows:
path.basename('C:\\temp\\myfile.html');
// Returns: 'myfile.html'

针对跨平台场景的单元测试需求，有三类成熟的实现方案，按需选择即可：

• 方案一：使用path模块内置的跨平台固定实现（最推荐，无侵入无兼容问题）
  node:path本身已经内置了两套独立的路径处理逻辑，不需要修改任何全局环境，就可以在任意操作系统上直接调用对应平台的方法：

  • 调用path.posix下的所有方法，固定执行POSIX平台的路径处理规则
  • 调用path.win32下的所有方法，固定执行Windows平台的路径处理规则
    示例代码：

  const path = require('node:path')
  
  // 任意运行环境下得到POSIX平台的执行结果
  path.posix.basename('C:\\temp\\myfile.html') // 返回 'C:\\temp\\myfile.html'
  
  // 任意运行环境下得到Windows平台的执行结果
  path.win32.basename('C:\\temp\\myfile.html') // 返回 'myfile.html'
  

  如果业务代码中直接引入默认path对象使用，可以在单元测试中通过模块mock能力，将默认导出替换为path.posix或path.win32即可，比如Jest测试框架下的mock写法：

  // 测试Windows场景
  jest.mock('node:path', () => require('node:path').win32)
  // 测试POSIX场景
  jest.mock('node:path', () => require('node:path').posix)
  

• 方案二：临时修改全局系统标识，适配其他系统判断逻辑
  如果你的代码中除了path模块，还依赖process.platform做系统分支判断，可以在测试用例中临时重写该属性，用例执行完成后恢复原值即可：

  const originalPlatform = process.platform
  
  test('windows场景测试', () => {
    // 临时修改为Windows平台标识
    Object.defineProperty(process, 'platform', { value: 'win32' })
    // 执行测试逻辑
    // ...
    // 恢复原始值避免影响其他用例
    Object.defineProperty(process, 'platform', { value: originalPlatform })
  })
  
  test('POSIX场景测试', () => {
    // 临时修改为Linux平台标识
    Object.defineProperty(process, 'platform', { value: 'linux' })
    // 执行测试逻辑
    // ...
    // 恢复原始值
    Object.defineProperty(process, 'platform', { value: originalPlatform })
  })
  

  注意：该方法仅能修改process.platform的返回值，不会改变node:path默认导出的底层逻辑，测试path行为时需要配合方案一的模块mock一起使用。

• 方案三：真实多操作系统环境运行测试（结果最准确）
  如果需要完全规避模拟环境和真实环境的行为差异，可以在CI流程中配置测试矩阵，分别在Windows、Linux、macOS三个真实操作系统环境下执行全量测试用例，得到的结果和生产环境表现完全一致。

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