本文讲解如何在 Jest 中正确模拟异步函数并防止测试间数据污染，重点解决因共享引用导致的 mockData.shift() 影响后续测试的问题。
本文讲解如何在 jest 中正确模拟异步函数并防止测试间数据污染，重点解决因共享引用导致的 `mockdata.shift()` 影响后续测试的问题。
在 Jest 单元测试中，若多个测试用例共用同一个数组（如 mockData）并对其执行 shift() 等原地修改操作，会导致后续测试读取到已被篡改的数据，从而引发不可预期的失败——正如问题中第二个测试返回 id: 2 而非预期的 id: 1。
根本原因在于：mockData 在 describe 块顶层声明，被所有 it 用例共享；而 data.shift() 直接修改了该数组的内部状态，破坏了测试隔离性。
Text To Image
下载
一款AI图像与设计工具，主要用于将文本渲染为图片并返回临时本地文件路径，支持可选的 data URI。适用于 Clawhub 或 Codex，用于将纯文本或带样式的文本进行转换，适合需要提升相关任务效率的用户。
✅ 正确做法：每个测试独立创建 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') 无法正确拦截。
? 最佳实践总结
| 项目 | 推荐做法 |
|---|---|
| Mock 数据生命周期 | 每个测试用例内声明，禁止跨用例复用可变对象 |
| 异步调用 | 所有 async 函数调用必须 await，避免 Promise 误用 |
| Mock 位置 | jest.mock() 放在文件顶部（module scope），保证模块加载前生效 |
| 清理机制 | 使用 afterEach(() => jest.clearAllMocks()) 保障测试间隔离 |
遵循以上原则，即可彻底杜绝因数据引用共享导致的测试污染问题，构建稳定、可维护的 Jest 测试套件。
