TypeScript：使用映射类型模拟接口以简化测试

兄弟我太懂你这个困扰了！每次写测试只需要接口里的一两个方法，结果TypeScript非要你把所有属性都实现，手动写一堆空mock又麻烦得要死，简直浪费时间对吧？下面给你几个实用的方案，完美解决这个问题：

方案一：Partial类型 + 双重断言（最简单直接） #

Partial<IFoo>会把接口里的所有属性转为可选，这样你只需要定义测试用到的方法，再通过双重断言告诉TypeScript“我知道这个对象不完整，但测试里不会用到未定义的属性”，就能彻底消除报错。

interface IFoo {
  myFunc(): string;
  otherFunc(): number;
}

// 只定义测试需要的myFunc
const mockFoo = {
  myFunc: jest.fn().mockReturnValue('测试返回值')
} as Partial<IFoo> as IFoo;

// 测试用例示例
test('调用myFunc返回正确结果', () => {
  const result = mockFoo.myFunc();
  expect(result).toBe('测试返回值');
  expect(mockFoo.myFunc).toHaveBeenCalled();
});

这种方法的优势是零额外代码，直接用TypeScript内置类型就能搞定，适合快速写测试的场景。

方案二：自定义Mocked映射类型（更优雅，类型更安全） #

如果你想让mock函数拥有完整的jest类型提示（比如.mockReturnValue、.toHaveBeenCalled()的自动补全），可以自定义一个映射类型，把接口的所有方法转为可选的jest.Mock类型：

import type { Mock } from 'jest';

// 自定义映射类型：将接口的每个方法转为可选的jest.Mock
type MockedInterface<T> = {
  [K in keyof T]?: Mock<ReturnType<T[K]>, Parameters<T[K]>>;
};

interface IFoo {
  myFunc(): string;
  otherFunc(): number;
}

// 创建mock对象，只实现需要的方法
const mockFoo: MockedInterface<IFoo> = {
  myFunc: jest.fn().mockReturnValue('测试返回值')
};

// 测试时的两种使用方式
test('使用非空断言调用mock', () => {
  // 非空断言告诉TypeScript：这个方法肯定存在
  const result = mockFoo.myFunc!();
  expect(result).toBe('测试返回值');
  expect(mockFoo.myFunc).toHaveBeenCalled();
});

test('断言为原接口类型传递给函数', () => {
  // 如果需要把mock对象传给期望IFoo类型参数的函数，直接断言即可
  const foo = mockFoo as IFoo;
  expect(foo.myFunc()).toBe('测试返回值');
});

这个方案的好处是类型推导更精准，写mock的时候能得到jest方法的智能提示，适合对类型严谨性有要求的场景。

方案三：jest.createMockFromModule（适合模块导出的接口） #

如果你的IFoo是从某个模块导出的，可以用jest自带的jest.createMockFromModule自动生成全量mock，再覆盖需要的方法：

// 假设IFoo来自./foo模块
import type { IFoo } from './foo';

// 自动生成模块的全量mock
const mockFoo = jest.createMockFromModule<IFoo>('./foo');
// 覆盖需要测试的方法
mockFoo.myFunc = jest.fn().mockReturnValue('测试返回值');

test('模块mock正常工作', () => {
  expect(mockFoo.myFunc()).toBe('测试返回值');
});

这个方法适合模块导出的类或对象，不需要手动定义mock结构，非常省心。

注意事项 #

测试时一定要确保不会调用未定义的方法，否则会触发运行时错误，但因为是测试场景，你完全可以控制测试用例的执行逻辑，所以这个风险是完全可控的。

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