本教程探讨如何在单元测试环境中有效管理 `lodash.once()` 函数的状态，以避免测试污染。我们将重点介绍如何使用 Jest 的模拟功能，将 `lodash.once()` 替换为一个透传函数，从而确保每次测试都能以干净、无缓存的状态运行，提高测试的隔离性和可靠性。
理解 lodash.once() 的作用与单元测试挑战
lodash.once() 是一个非常实用的函数，它接收一个函数作为参数，并返回一个新的函数。这个新函数无论被调用多少次，原始函数都只会执行一次，并缓存其结果。后续的调用将直接返回这个缓存的结果。这在优化性能、避免重复计算或确保某些初始化逻辑只执行一次的场景中非常有用。
然而，once() 的这种状态持久性在单元测试中却可能成为一个问题。当测试一个依赖于 once() 包装的函数的组件时，如果 once() 的内部状态（即它是否已经执行过）在不同的测试用例之间没有被重置，那么前一个测试的执行可能会影响到后一个测试的结果，导致所谓的“测试污染”。例如，如果一个测试用例触发了 once() 包装的函数执行，那么在下一个测试用例中，该函数将不再执行，而是直接返回上一个测试的缓存结果，这可能与我们期望的测试行为不符。为了实现测试的隔离性和可重复性，我们需要一种机制来“重置” once() 的状态。
核心策略：利用 Jest 模拟 lodash.once()
解决 lodash.once() 在单元测试中状态污染问题的核心策略是使用 Jest 的模拟（mocking）功能。我们可以将 lodash.once() 替换为一个自定义的模拟实现，使其在测试环境中表现出我们期望的行为，即不进行缓存或可以被重置。
以下是使用 Jest 模拟 lodash.once() 的代码示例：
// 在你的测试文件顶部或 Jest 的 setupFilesAfterEnv 配置中
jest.mock("lodash", () => ({
...jest.requireActual("lodash"), // 保留 lodash 其他未被模拟的函数
once: jest.fn((fn) => fn), // 模拟 lodash.once
}));
// 示例：一个依赖 lodash.once 的函数
const expensiveCalculation = jest.fn(() => {
console.log("Performing expensive calculation...");
return 42;
});
const getResultOnce = _.once(expensiveCalculation);
describe("Testing a component that uses lodash.once", () => {
// 在每个测试用例之前清除 Jest 模拟的状态
beforeEach(() => {
jest.clearAllMocks();
});
test("should call the wrapped function every time when once is mocked", () => {
// 第一次调用
const result1 = getResultOnce();
expect(result1).toBe(42);
expect(expensiveCalculation).toHaveBeenCalledTimes(1);
// 第二次调用
const result2 = getResultOnce();
expect(result2).toBe(42);
// 因为 once 被模拟为透传，expensiveCalculation 应该再次被调用
expect(expensiveCalculation).toHaveBeenCalledTimes(2);
});
test("another test case should also call the wrapped function every time", () => {
// 确保在新的测试用例中，expensiveCalculation 再次从零开始计数
const result3 = getResultOnce();
expect(result3).toBe(42);
expect(expensiveCalculation).toHaveBeenCalledTimes(1); // 注意：这里是 1，因为 beforeEach 清除了模拟
});
});深入解析模拟行为
- jest.mock("lodash", ...): 这告诉 Jest 拦截对 lodash 模块的所有导入，并用我们提供的对象替换它。
- ...jest.requireActual("lodash"): 这一部分至关重要。它确保 lodash 模块中除了我们明确模拟的函数之外，其他所有真实的函数（如 map, filter 等）都能正常工作。这样可以避免不必要的副作用，只修改我们关心的部分。
-
once: jest.fn((fn) => fn): 这是模拟的核心。我们将 lodash.once 替换为一个 Jest 模拟函数。
- jest.fn(...) 创建了一个可被 Jest 跟踪的函数，我们可以检查它是否被调用、被调用了多少次等。
- (fn) => fn 是这个模拟函数的实现。它接收原始函数 fn 作为参数，并直接返回 fn 本身。
这意味着，当你的代码中调用 _.once(myFunction) 时，它实际上得到的是 myFunction 本身，而不是一个被 once 包装过的、具有缓存行为的函数。因此，每次调用 _.once(myFunction) 的结果（即 myFunction 本身）都会执行 myFunction 的完整逻辑，从而有效地消除了 once 的缓存行为。对于单元测试来说，这达到了“重置” once 的效果，因为它确保了每次调用都能触发原始函数的执行，从而保证了测试间的隔离性。
在上面的示例中，beforeEach(() => { jest.clearAllMocks(); }); 确保了在每个测试用例开始时，expensiveCalculation 的调用计数器都被重置，进一步增强了测试的隔离性。
适用场景与扩展思考
- 适用于 lodash-es: 这种模拟方法同样适用于 lodash-es，你只需将 jest.mock("lodash", ...) 替换为 jest.mock("lodash-es", ...)。
- 测试隔离: 这种模拟方法的主要优势在于它提供了一种简单而强大的方式来隔离测试，确保 lodash.once() 的状态不会在测试用例之间泄露。
- 何时使用: 当你的测试目标是验证被 once 包装的函数本身的逻辑，或者验证依赖于该函数执行次数的组件行为时，这种模拟非常有用。它允许你绕过 once 的缓存机制，确保每次都能触发原始函数的执行。
- 更复杂的模拟: 如果你的测试需要验证 once 的 缓存行为 本身，或者你需要一个 可控地 缓存并能手动重置的 once 版本，那么你需要实现一个更复杂的模拟。例如，你可以创建一个内部维护状态的模拟函数，并暴露一个 reset 方法供测试调用。然而，对于大多数单元测试场景，简单的透传模拟已足够。
注意事项
- 模拟位置: 确保 jest.mock 调用在测试文件顶部，或者在 Jest 的 setupFilesAfterEnv 配置中，以确保在模块被导入和使用之前生效。
- 影响范围: 这种模拟会全局影响所有导入 lodash 的模块。在某些复杂的测试场景中，你可能需要考虑更细粒度的模拟，例如使用 jest.spyOn 或在特定测试文件中局部模拟。然而，对于解决 once() 的测试污染问题，全局模拟通常是最直接有效的方式。
- 测试目的: 明确你的测试目的是什么。如果你想测试 once 包装的函数本身的逻辑，那么透传模拟是理想选择。如果你想测试 once 的缓存机制是否按预期工作，那么你需要一个更真实的 once 模拟，或者直接测试 lodash 库本身（这通常不是单元测试的目标）。
总结
通过利用 Jest 强大的模拟能力，我们可以轻松地管理 lodash.once() 等具有内部状态的第三方库函数在单元测试中的行为。将 once() 模拟为一个简单的透传函数，可以有效地消除其缓存机制带来的测试污染，确保每个测试用例都能在一个干净、可预测的环境中运行。这种技术不仅提高了测试的可靠性，也简化了对复杂组件的测试流程，是现代 JavaScript 单元测试中不可或缺的工具。
