如何用Jest和TypeScript测试类异步方法？mock返回空对象问题排查

大概率是这几个常见操作失误导致的，逐个排查：

1. jest.mock 和 spyOn 重复Mock冲突 #

如果同时用了jest.mock整个User模块，又用spyOn监听其静态方法，会导致mock状态混乱——jest.mock会替换整个模块为mock类，此时spyOn无法正确绑定原类的方法。

解决办法：二选一，要么只用spyOn，要么用jest.mock配合mockImplementation修改方法行为。

2. 异步方法的Mock返回值未正确处理Promise #

getUser是异步方法，mock时必须返回resolved状态的Promise，如果直接用mockReturnValue返回User实例，会导致方法返回的Promise包裹的内容不符合预期，看起来像空对象。

正确姿势：用mockResolvedValue或者mockImplementation返回Promise。

3. User类实例本身是空的 #

如果你的User构造函数没有把参数挂载到this上，比如写了const id = id而不是this.id = id，那就算实例化了，对象也是空的。先检查类的实现是否正确。

正确代码示例 #

先确保User类实现没问题

// User.js
class User {
  constructor(id, name) {
    // 必须把属性挂载到this上
    this.id = id;
    this.name = name;
  }

  static async getUser(userId) {
    // 真实逻辑：从数组查找用户
    const users = [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}];
    const matched = users.find(u => u.id === userId);
    return matched ? new User(matched.id, matched.name) : null;
  }
}

module.exports = User;

测试写法一：只用spyOn

// User.test.js
const User = require('./User');

test('mock getUser 返回正确的User实例', async () => {
  // 创建一个真实的User实例
  const mockUser = new User(1, 'MockAlice');
  // spy异步静态方法，用mockResolvedValue返回Promise包裹的实例
  const getUserSpy = jest.spyOn(User, 'getUser').mockResolvedValue(mockUser);

  // 必须await异步方法的结果
  const result = await User.getUser(1);

  expect(result).toEqual(mockUser);
  expect(result.id).toBe(1);
  expect(getUserSpy).toHaveBeenCalledWith(1);

  // 测试后清理spy，避免影响其他测试
  getUserSpy.mockRestore();
});

测试写法二：用jest.mock配合mockImplementation

// User.test.js
const User = require('./User');

// Mock整个模块，但保留原类的构造函数
jest.mock('./User', () => {
  const OriginalUser = jest.requireActual('./User');
  return {
    ...OriginalUser,
    getUser: jest.fn()
  };
});

test('mock getUser 返回正确的User实例', async () => {
  const mockUser = new User(1, 'MockAlice');
  // 修改mock方法的返回值为resolved的Promise
  User.getUser.mockResolvedValue(mockUser);

  const result = await User.getUser(1);

  expect(result).toEqual(mockUser);
  expect(User.getUser).toHaveBeenCalledWith(1);
});

额外注意点 #

• 必须await异步方法的调用结果，否则拿到的是Promise对象，不是实例，断言会失败。
• 如果用ES6模块的export default，mock时要对应调整：比如jest.mock('./User', () => ({ default: { ...OriginalUser.default, getUser: jest.fn() } }))。

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