首页 > 文章 > 前端

Jest单元测试与mock技巧详解

时间：2026-02-25 17:11:51 497浏览收藏

本文深入浅出地讲解了如何使用 Jest 进行高质量 JavaScript 单元测试，从零配置起步，覆盖基础断言、mock 函数（jest.fn）、模块模拟（jest.mock）、方法监听（jest.spyOn）到定时器控制等核心技巧，并强调“测试行为而非实现”的设计哲学与清理 mock 状态等关键最佳实践——无论你是刚接触测试的新手，还是希望提升测试可靠性和重构信心的开发者，都能从中获得即学即用的实战能力与清晰的测试思维。

JavaScript 测试驱动：Jest 单元测试编写与 mock 技巧

测试驱动开发（TDD）在现代 JavaScript 开发中扮演着重要角色，而 Jest 作为目前最流行的测试框架之一，提供了简洁的 API 和强大的功能，让编写单元测试变得高效且可靠。本文将介绍如何使用 Jest 编写高质量的单元测试，并掌握关键的 mock 技巧。

理解单元测试与 Jest 基础

单元测试关注的是最小可测代码单元，比如一个函数或类方法。Jest 提供了开箱即用的体验，无需复杂配置即可运行测试。

安装 Jest：

npm install --save-dev jest

在 package.json 中添加脚本：

"scripts": { "test": "jest" }

编写一个简单的函数并测试它：

// math.js function add(a, b) { return a + b; } module.exports = { add }; // math.test.js const { add } = require('./math'); test('adds 1 + 2 to equal 3', () => { expect(add(1, 2)).toBe(3); });

运行 npm test 即可看到测试通过。Jest 的 expect().toBe() 使用严格相等，适合基本类型比较。

Mock 函数：控制外部依赖

在真实项目中，函数常依赖外部模块、API 或定时器。使用 mock 可以隔离这些依赖，确保测试只关注当前逻辑。

Jest 提供 jest.fn() 创建模拟函数：

test('calls callback once', () => { const mockFn = jest.fn(); someFunction(mockFn); expect(mockFn).toHaveBeenCalledTimes(1); });

你还可以为 mock 函数指定返回值：

mockFn.mockReturnValue('hello'); expect(mockFn()).toBe('hello');

查看调用参数也很方便：

expect(mockFn).toHaveBeenCalledWith('arg1');

Mock 模块：替换整个依赖模块

当你的代码引入了外部库（如 axios、fs），可以用 jest.mock() 替换整个模块。

// api.js const axios = require('axios'); async function fetchUser(id) { const res = await axios.get(`/users/${id}`); return res.data; } // api.test.js const axios = require('axios'); jest.mock('axios'); test('fetches user data', async () => { axios.get.mockResolvedValue({ data: { id: 1, name: 'John' } }); const user = await fetchUser(1); expect(user.name).toBe('John'); expect(axios.get).toHaveBeenCalledWith('/users/1'); });

这里通过 mockResolvedValue 模拟异步成功响应，避免真实网络请求。