如何使 Jest 模拟函数默认抛出错误以提高测试效率

在前端单元测试场景中，验证业务代码对依赖异常的处理逻辑是重要环节。传统方式下每次测试需要手动设置模拟函数的错误抛出行为，会产生大量重复代码，降低测试编写效率。通过配置让Jest模拟函数默认抛出错误，可以有效减少这类重复工作。

为什么需要模拟函数默认抛出错误

当我们要测试一个调用了外部依赖的函数时，比如一个数据请求函数调用了封装好的接口请求模块，需要验证当接口请求失败（即依赖抛出错误）时，业务函数是否能正确捕获错误并返回预期结果。如果每次测试这个场景都要单独写模拟错误抛出的代码，会非常繁琐。

举一个常见的场景：我们有一个用户信息服务，依赖用户接口请求模块，现在要测试当接口请求失败时，用户信息服务是否正确返回错误提示。如果不配置默认抛出错误，每个相关测试用例都要重复写模拟错误的代码。

基础配置方式：修改模拟函数的默认实现

Jest的模拟函数可以通过mockImplementation或者mockImplementationOnce来修改默认行为，我们可以借助这个特性设置默认抛出错误。首先看一个简单的示例，假设我们有一个依赖模块userApi.js，里面有一个获取用户信息的函数：

// userApi.js
export const getUserInfo = (userId) => {
  // 实际场景中是接口请求逻辑
  return Promise.resolve({ id: userId, name: 'test' });
};

现在我们编写测试文件，让这个模块的getUserInfo函数默认抛出错误：

// userApi.test.js
import { getUserInfo } from './userApi';

// 模拟整个模块
jest.mock('./userApi');

// 配置模拟函数默认抛出错误
getUserInfo.mockImplementation(() => {
  throw new Error('默认模拟错误');
});

describe('用户接口模拟默认抛出错误测试', () => {
  test('验证模拟函数默认抛出错误', () => {
    expect(() => getUserInfo(1)).toThrow('默认模拟错误');
  });
});

上面的配置会让getUserInfo在所有测试用例中默认抛出错误，除非某个测试用例单独修改了它的行为。如果某个测试用例需要模拟正常返回的情况，可以单独用mockImplementationOnce覆盖：

test('单个用例模拟正常返回', () => {
  // 仅当前用例生效的正常返回模拟
  getUserInfo.mockImplementationOnce(() => ({ id: 1, name: '张三' }));
  const result = getUserInfo(1);
  expect(result).toEqual({ id: 1, name: '张三' });
});

针对Promise类型模拟函数的配置

如果模拟的是异步函数，返回的是Promise，那么默认抛出错误需要返回rejected状态的Promise，配置方式如下：

// 模拟异步函数默认抛出错误（返回rejected Promise）
getUserInfo.mockImplementation(() => {
  return Promise.reject(new Error('接口请求失败'));
});

// 测试用例验证异步错误捕获
test('验证异步模拟函数默认抛出错误', async () => {
  await expect(getUserInfo(1)).rejects.toThrow('接口请求失败');
});

全局默认配置：减少重复设置

如果有多个模拟函数都需要默认抛出错误，可以把配置逻辑放到测试文件的beforeEach中，这样每个测试用例执行前都会自动应用默认配置，不需要在每个用例里重复写：

import { getUserInfo, getUserList } from './userApi';

jest.mock('./userApi');

beforeEach(() => {
  // 配置多个模拟函数默认抛出错误
  getUserInfo.mockImplementation(() => Promise.reject(new Error('getUserInfo默认错误')));
  getUserList.mockImplementation(() => Promise.reject(new Error('getUserList默认错误')));
});

describe('多模拟函数默认错误测试', () => {
  test('getUserInfo默认错误验证', async () => {
    await expect(getUserInfo(1)).rejects.toThrow('getUserInfo默认错误');
  });

  test('getUserList默认错误验证', async () => {
    await expect(getUserList()).rejects.toThrow('getUserList默认错误');
  });

  test('单个用例覆盖getUserInfo默认行为', async () => {
    getUserInfo.mockImplementationOnce(() => Promise.resolve({ id: 1 }));
    const result = await getUserInfo(1);
    expect(result).toEqual({ id: 1 });
  });
});

注意事项

• 默认抛出错误的配置会作用于所有未单独覆盖的测试用例，如果某个用例需要正常返回，一定要用mockImplementationOnce单独设置，避免影响其他用例。
• 如果模拟的是非模块导出的函数，比如某个内部函数，需要通过其他方式模拟时，同样可以用jest.spyOn配合mockImplementation来设置默认错误抛出。
• 错误内容尽量设置得有辨识度，方便测试失败时快速定位是哪个模拟函数抛出的错误。

实际效果对比

我们对比一下配置默认抛出错误前后的测试代码量：

通过这种方式，我们可以大幅减少单元测试中的重复代码，把更多精力放在测试逻辑本身，有效提升测试编写和维护的效率。

Jest模拟函数默认抛出错误测试效率单元测试修改时间：2026-07-17 06:24:29