在使用 `jest-mock-extended` 进行单元测试时，未显式模拟的函数默认返回 `undefined`，这可能导致难以追踪的测试失败。本教程将介绍如何利用 `jest-mock-extended` 的 `fallbackmockimplementation` 特性，使所有未模拟的函数默认抛出错误，从而提前发现并定位问题，显著提升测试的健壮性和调试效率。
默认模拟行为与潜在问题
当我们在 Jest 中使用 jest-mock-extended 库创建模拟对象时，如果接口中的某个方法没有被显式地提供模拟实现，它将默认返回 undefined。
考虑以下接口和模拟示例：
export interface SomeClient {
someFunction(): number;
someOtherFunction(): number;
}
// 创建模拟对象
const mockClient = mock();
// 只为 someFunction 提供实现
mockClient.someFunction.mockImplementation(() => 1);
// 调用结果
mockClient.someFunction(); // 返回 1
mockClient.someOtherFunction(); // 返回 undefined 这种默认返回 undefined 的行为虽然在某些情况下可以接受，但在以下场景中可能导致难以发现和调试的问题：
- 隐蔽的错误源： 被测代码可能不期望接收 undefined 值。这可能导致它立即抛出错误，或者更糟的是，在程序的更深层级引发意想不到的行为或错误，使得问题的根源难以定位。
- 类型不匹配： 如果项目使用 TypeScript，undefined 值可能与接口定义的预期返回类型不匹配，从而引入潜在的类型安全问题。
- 测试覆盖不足： 默认的 undefined 返回可能让测试通过，但实际上并没有真正覆盖到该函数被调用时的预期行为，从而降低了测试的有效性。
为了更早、更清晰地发现这些“未模拟”的问题，一种理想的策略是让所有未显式模拟的函数在被调用时抛出错误。
传统解决方案的局限性
一种直接但繁琐的方法是为接口中的每个方法手动添加一个抛出错误的模拟实现：
const mockClient = mock({ someFunction: jest.fn().mockImplementation(() => { throw new Error('someFunction 未模拟'); }), someOtherFunction: jest.fn().mockImplementation(() => { throw new Error('someOtherFunction 未模拟'); }), });
这种方法虽然能达到目的，但存在明显缺陷：
- 冗余和维护成本高： 当接口包含大量方法时，手动为每个方法添加相同的错误抛出逻辑会非常冗余。
- 扩展性差： 如果接口新增了方法，必须手动更新所有相关的模拟对象，否则新方法仍然会默认返回 undefined，再次引入潜在问题。
显然，我们需要一种更优雅、更自动化的方式来处理这种情况。
优化方案：利用 fallbackMockImplementation
jest-mock-extended 库在版本 3.0.2 及更高版本中引入了一个名为 fallbackMockImplementation 的强大特性。这个选项允许我们为所有未显式模拟的函数提供一个默认的实现。通过利用此特性，我们可以轻松地让未模拟的函数在被调用时抛出错误。
fallbackMockImplementation 作为一个配置项，可以在 mock() 函数的第二个参数中传递。
示例代码
以下是如何使用 fallbackMockImplementation 来实现默认抛出错误的行为：
import { mock } from 'jest-mock-extended';
interface SomeClient {
someFunction(): number;
someOtherFunction(): number;
anotherFunction(arg: string): boolean;
}
describe('使用 fallbackMockImplementation 强制未模拟函数抛出错误', () => {
test('未显式模拟的函数应抛出错误', () => {
const mockClient = mock(
{}, // 第一个参数用于提供具体的模拟实现（此处为空对象表示没有初始实现）
{
// 第二个参数是配置对象
fallbackMockImplementation: () => {
throw new Error('此方法未被模拟！');
},
},
);
// 验证未显式模拟的函数调用时会抛出错误
expect(() => mockClient.someFunction()).toThrowError('此方法未被模拟！');
expect(() => mockClient.someOtherFunction()).toThrowError('此方法未被模拟！');
expect(() => mockClient.anotherFunction('test')).toThrowError('此方法未被模拟！');
// 如果需要为特定函数提供实现，可以稍后覆盖
mockClient.someFunction.mockReturnValue(42);
expect(mockClient.someFunction()).toBe(42);
// 此时 someOtherFunction 仍然会抛出错误
expect(() => mockClient.someOtherFunction()).toThrowError('此方法未被模拟！');
});
test('可以为特定函数提供具体的模拟实现', () => {
const mockClient = mock(
{
someFunction: jest.fn().mockReturnValue(100) // 提供初始模拟
},
{
fallbackMockImplementation: () => {
throw new Error('此方法未被模拟！');
},
},
);
expect(mockClient.someFunction()).toBe(100); // 已模拟的函数正常工作
expect(() => mockClient.someOtherFunction()).toThrowError('此方法未被模拟！'); // 未模拟的函数抛出错误
});
}); 在这个例子中，我们通过 fallbackMockImplementation 配置了一个函数，该函数在任何未被显式模拟的方法被调用时都会被执行，并抛出一个带有明确信息的错误。这使得测试在早期就能发现哪些模拟函数被遗漏了实现，极大地提高了调试效率和测试的可靠性。
注意事项与最佳实践
- 版本要求： 确保你的 jest-mock-extended 版本至少为 3.0.2。如果版本过低，此功能将不可用。
- 错误信息： 在 fallbackMockImplementation 中抛出的错误信息应该尽可能具体，例如包含函数名或接口名，以便于快速定位问题。虽然示例中使用了通用信息，但在实际项目中，可以考虑动态生成更详细的错误信息。
- 测试场景： 这种策略特别适用于对模拟行为有严格要求的项目，或者当接口定义复杂且容易遗漏模拟实现时。它有助于强制开发者为所有相关的模拟函数提供明确的实现。
- 与 mockImplementation 结合： fallbackMockImplementation 仅在没有其他模拟实现（包括通过 mockImplementation 或 mockReturnValue 设置的实现）时才会被触发。这意味着你可以先设置一个全局的错误抛出机制，然后按需为特定的函数提供具体的模拟行为。
总结
通过 jest-mock-extended 提供的 fallbackMockImplementation 特性，我们可以优雅地解决未模拟函数默认返回 undefined 所带来的潜在问题。这种方法不仅能够强制开发者为模拟函数提供明确的实现，还能在测试的早期阶段就发现并报告遗漏的模拟，从而显著提升单元测试的健壮性、可维护性和调试效率。采用这种策略，可以帮助我们构建更加可靠和易于理解的测试套件。
