Node.js Jest单元测试：是否需要耗尽所有Mock实现？

我们在Rancher Desktop的测试代码中，通过jest.mocked(fetch).mockImplementationOnce连续定义了5个fetch的Mock实现。第一个测试用例仅调用fetch 4次，未触发第5个Mock实现，但后续新增的测试用例调用fetch时，却命中了前一个测试残留的第5个Mock实现。我们已经在beforeEach钩子中使用mockClear清除Mock状态，但问题依旧。而如果在第一个测试用例中主动调用第5次fetch（捕获错误），第二个测试用例就能正常运行。

想确认：编写新的基于mockImplementationOnce的fetch Mock测试用例前，是否必须耗尽所有已定义的Mock实现？Jest官方文档并未提及未耗尽Mock实现的跨测试影响。

• 核心结论：是的，使用mockImplementationOnce定义的未耗尽Mock实现会跨测试用例残留，哪怕调用了mockClear也无法解决。
• 深层原因：mockClear仅清除Mock的调用历史、实例记录及返回值缓存，但不会重置mockImplementationOnce的执行队列。mockImplementationOnce是将Mock实现按顺序加入一个队列，每次调用Mock时会从队列头部取出一个实现使用，未被取用的实现会一直留在队列中，下一个测试用例调用该Mock时会继续取用剩余的实现。
• 解决办法：
  1. 改用mockReset()：在beforeEach或afterEach中调用jest.mocked(fetch).mockReset()，它会完全重置Mock的状态，包括清空mockImplementationOnce的执行队列，比mockClear的重置力度更彻底。
  2. 确保耗尽当前测试的Mock实现：每个测试用例中，若用mockImplementationOnce定义了N个实现，就确保该测试内调用Mock至少N次（哪怕最后一次是捕获错误的调用），避免残留到下一个测试。
  3. 独立设置每个测试的Mock：每个测试用例单独定义自己需要的mockImplementationOnce实现，不依赖其他测试的Mock设置，从根源上避免跨测试的Mock残留问题。

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