Jest 测试中规避 mock 数据对象被后续用例污染的正确实践

本文讲解如何在 Jest 中正确模拟异步函数并防止测试间数据污染，重点解决因共享引用导致的 mockData.shift() 影响后续测试的问题。

本文讲解如何在 jest 中正确模拟异步函数并防止测试间数据污染，重点解决因共享引用导致的 `mockdata.shift()` 影响后续测试的问题。

在 Jest 单元测试中，若多个测试用例共用同一个数组（如 mockData）并对其执行 shift() 等原地修改操作，会导致后续测试读取到已被篡改的数据，从而引发不可预期的失败——正如问题中第二个测试返回 id: 2 而非预期的 id: 1。

根本原因在于：mockData 在 describe 块顶层声明，被所有 it 用例共享；而 data.shift() 直接修改了该数组的内部状态，破坏了测试隔离性。

✅ 正确做法：每个测试独立创建 mock 数据

应将 mockData 的初始化移至每个 it 块内，确保每次测试都获得一个全新、未被修改的数组实例：

it('Should return a id 1', async () => {  const mockData = [{ id: 1 }, { id: 2 }, { id: 3 }]; // ✅ 每次新建  getData.mockResolvedValue(mockData);  const response = await Helpers.execute();  expect(response.id).toBe(1);});it('Should return a id 1 with true flag', async () => {  const mockData = [{ id: 1 }, { id: 2 }, { id: 3 }]; // ✅ 独立副本  getData.mockResolvedValue(mockData);  track.mockResolvedValue({});  const response = await Helpers.execute(true);  expect(response.id).toBe(1);});

⚠️ 关键修复点补充说明

• 必须 await getData()：getData 是 async 函数，直接调用返回的是 Promise，需 await 获取实际数组，否则 data.shift() 会作用于 Promise 对象（报错或逻辑错误）。
• jest.mock() 应置于模块顶层：避免在 beforeAll 中动态 mock，否则可能触发模块缓存问题；推荐在文件顶部静态 mock，并配合 jest.clearAllMocks() 在 afterEach 中重置行为。
• 导出方式需匹配 import：operations.js 中 getData 和 track 必须使用 export（而非仅函数声明），否则 jest.mock('./operations') 无法正确拦截。

? 最佳实践总结

遵循以上原则，即可彻底杜绝因数据引用共享导致的测试污染问题，构建稳定、可维护的 Jest 测试套件。