Jest基于CommonJS语法Mock类时无法验证目标方法被调用的问题

核心结论 #

CommonJS 原生 require 场景完全可以实现类Mock与方法调用验证，不存在语法层面的不兼容，之前的方案失效完全是踩中了Jest Mock的两个常见逻辑误区。

失效根因 #

• 业务代码user-consumer.js在模块加载阶段就完成了new User()实例化，后续测试代码中自己新建的User实例，和业务代码内部已经生成的实例不是同一个对象。给测试侧新建实例的方法打spy、做断言，完全不会影响业务代码内部已经持有的旧实例的方法调用。
• 测试中搭配jest.spyOn的写法存在逻辑偏差：jest.spyOn(user, 'getName')是在测试侧新建的实例上单独覆盖了getName方法，业务代码持有的实例从未触发这个被spy的方法，自然会出现“方法未被调用”的报错。
• 自定义模块工厂写Mock时的常见问题：如果每次调用new User()都生成全新的独立实例，每个实例绑定独立的mock方法，业务代码生成的是第一个实例，测试侧拿到的是后续新建的其他实例，不同实例的方法状态完全隔离，自然无法捕获到业务代码的实际调用。这也是为什么自定义Mock后，业务函数仍然返回原始值的核心原因——业务代码用到的实例方法和测试侧看到的mock方法根本不是同一个引用。

可落地的实现方案 #

方案一：利用自动Mock的原型共享特性 #

Jest自动Mock类时，会把类的所有原型方法统一替换为jest.fn()，从该类生成的所有实例，调用方法时都会共享同一个原型方法引用，不存在实例间的状态隔离。
对应的测试代码调整：

// user.test.js
const userConsumer = require('./user-consumer')
const User = require('./user')

// 自动mock会自动将User原型上的getName替换为jest.fn()
jest.mock('./user')

it('should mock', () => {
  userConsumer.getUserName()
  // 直接断言原型上的getName被调用，不需要手动新建实例
  expect(User.prototype.getName).toBeCalled()
})

注意事项：

• 因为原型方法是所有实例共享的，需要在每次测试前通过jest.clearAllMocks()清理历史调用记录，避免不同测试用例的断言互相干扰。

方案二：自定义Mock工厂缓存单例实例 #

如果需要更精细的实例方法控制，可以在mock工厂内维护一个单例实例，将该实例的引用暴露给测试侧，保证业务代码和测试代码拿到的是同一个对象。
对应的自定义Mock写法：

jest.mock('./user', () => {
  // 在模块作用域维护单例mock实例
  const mockUserInstance = {
    getName: jest.fn(() => 'Mocked Name')
  }
  // Mock类实现，无论多少次new都返回同一个单例
  const MockUser = jest.fn(() => mockUserInstance)
  // 把单例挂到Mock类上，方便测试代码获取
  MockUser.mockInstance = mockUserInstance
  return MockUser
})

测试侧直接获取缓存的实例做断言即可：

it('should mock', () => {
  userConsumer.getUserName()
  expect(User.mockInstance.getName).toBeCalled()
})

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