TypeScript中使用jest.mock如何避免繁琐类型转换及TS报错？

这个报错的核心原因很直白：Jest在运行时会把fs模块里的函数替换成Mock函数，但TypeScript的类型系统还是沿用了fs模块的原始类型定义——原始的readFile只是普通函数类型，根本没有mockImplementationOnce这类Mock专属方法，所以编译器自然会报错。

下面给你两个无需繁琐类型转换的简洁解决方案：

方案一：用jest.spyOn替代全局mock（推荐） #

如果你只需要mockreadFile这一个函数，jest.spyOn是最省心的选择，它会自动返回带有完整Mock类型的函数，TypeScript能完美识别：

import * as fs from 'fs';
import { fnThatReadsFile } from './lib';

it('should read a file', () => {
  // 用spyOn获取mock函数，类型自动适配
  const mockReadFile = jest.spyOn(fs, 'readFile').mockImplementationOnce((_, callback) => {
    const err = {};
    callback(err, null); // 补全你的返回值逻辑
  });

  // 执行被测函数
  fnThatReadsFile();

  // 做断言
  expect(mockReadFile).toHaveBeenCalled();
});

测试结束后，还可以用mockReadFile.mockRestore()恢复原始的readFile函数，避免影响其他测试用例。

方案二：全局mock后显式声明Mock类型 #

如果你必须用jest.mock('fs')来mock整个模块，可以通过极简的类型断言把readFile转换成Jest Mock函数类型，完全算不上繁琐：

import * as fs from 'fs';
import { fnThatReadsFile } from './lib';

jest.mock('fs'); // 全局mock整个fs模块

// 把readFile声明为Mock函数类型，复用原始函数签名
const mockedReadFile = fs.readFile as jest.MockedFunction<typeof fs.readFile>;

it('should read a file', () => {
  const err = {};
  mockedReadFile.mockImplementationOnce((_, callback) => callback(err, null));

  fnThatReadsFile();

  expect(mockedReadFile).toHaveBeenCalled();
});

这个方法利用了Jest内置的jest.MockedFunction类型，直接适配原始函数的签名，不需要手动定义复杂类型。

最后别忘了确认你已经安装了@types/jest和@types/node这两个类型包，否则TypeScript无法识别Jest和Node.js模块的类型。

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