高级单元测试模式
中等 约 40 分钟
你将构建什么
一个字符串工具模块的综合测试套件,使用参数化测试、自定义匹配器和 beforeEach/afterEach 钩子实现干净的测试隔离。
学习目标
- 编写参数化/数据驱动测试
- 创建自定义 Jest/Vitest 匹配器
- 有效使用 setup 和 teardown 钩子
- 测试边界条件和极端情况
前置要求
- 基本测试语法(describe、it、expect)
- 断言和匹配器
- JavaScript/TypeScript 函数
步骤
- 1
创建工具模块
创建一个字符串工具模块,包含待测试函数:capitalize、truncate、slugify 和 camelCase。
代码// src/utils/stringUtils.ts export function capitalize(s: string): string { if (!s) return s; return s[0].toUpperCase() + s.slice(1).toLowerCase(); } export function truncate(s: string, max: number): string { if (s.length <= max) return s; return s.slice(0, max - 3) + '...'; } export function slugify(s: string): string { return s.toLowerCase().trim().replace(/[^\w\s-]/g, '').replace(/[\s_-]+/g, '-'); } export function camelCase(s: string): string { return s.replace(/[^\w]+(.)/g, (_, c) => c.toUpperCase()); }预期结果
导出四个工具函数,准备测试。
- 2
编写参数化测试
使用 it.each 对多个输入运行相同测试。这避免了为类似断言重复测试代码。
代码import { capitalize, slugify } from '../utils/stringUtils'; describe('capitalize', () => { it.each([ ['hello', 'Hello'], ['HELLO', 'Hello'], ['h', 'H'], ['', ''], ])('capitalize(%j) === %j', (input, expected) => { expect(capitalize(input)).toBe(expected); }); }); describe('slugify', () => { it.each([ ['Hello World', 'hello-world'], [' Multiple Spaces ', 'multiple-spaces'], ['Special!@#Chars', 'specialchars'], ])('slugify(%j) === %j', (input, expected) => { expect(slugify(input)).toBe(expected); }); });预期结果
所有参数化用例通过 —— 一个测试定义覆盖多个输入。
- 3
创建自定义匹配器
扩展 expect 添加自定义匹配器 toBeWithinRange,检查数字是否在范围内。自定义匹配器让领域特定断言更易读。
代码expect.extend({ toBeWithinRange(received: number, floor: number, ceiling: number) { const pass = received >= floor && received <= ceiling; return { pass, message: () => pass ? `expected ${received} not to be within range [${floor}, ${ceiling}]` : `expected ${received} to be within range [${floor}, ${ceiling}]`, }; }, }); // Usage it('truncate length is within bounds', () => { const result = truncate('a very long string here', 10); expect(result.length).toBeWithinRange(0, 10); });预期结果
自定义匹配器工作正常,产生清晰的失败信息。
- 4
使用 setup 和 teardown 钩子
使用 beforeEach 和 afterEach 设置和清理测试状态。这对共享设置逻辑或修改全局状态的测试至关重要。
代码describe('with mock console', () => { let mockLog: jest.Mock; beforeEach(() => { mockLog = jest.spyOn(console, 'log').mockImplementation(); }); afterEach(() => { mockLog.mockRestore(); }); it('does not log on normal operation', () => { capitalize('test'); expect(mockLog).not.toHaveBeenCalled(); }); });预期结果
console.log 在每个测试前被 mock,测试后恢复 —— 测试间无副作用。
- 5
测试边界条件
系统化测试边界情况:空字符串、单字符、超长字符串和 Unicode 字符。边界测试捕获差一错误和编码 bug。
代码describe('boundary conditions', () => { it('handles empty string', () => { expect(capitalize('')).toBe(''); expect(truncate('', 10)).toBe(''); expect(slugify('')).toBe(''); }); it('handles single character', () => { expect(capitalize('x')).toBe('X'); }); it('handles unicode', () => { expect(capitalize('über')).toBe('Über'); expect(slugify('café au lait')).toBe('caf-au-lait'); }); it('truncate at exact boundary', () => { expect(truncate('12345678', 8)).toBe('12345678'); expect(truncate('123456789', 8)).toBe('12345...'); }); });预期结果
所有边界用例通过,确认函数正确处理边界输入。
自己动手试试
起始代码
import { capitalize } from '../utils/stringUtils';
describe('capitalize', () => {
// TODO: write parameterized tests
});解决方案代码
import { capitalize, slugify, truncate, camelCase } from '../utils/stringUtils';
describe('capitalize', () => {
it.each([['hello', 'Hello'], ['', '']])('capitalize(%j) === %j', (i, e) => {
expect(capitalize(i)).toBe(e);
});
});你学到了什么
你掌握了高级测试模式 —— 用于覆盖的参数化测试、用于可读性的自定义匹配器、用于隔离的钩子,以及用于健壮性的边界测试。这些技术可扩展到大型测试套件。
相关资源
相关课程
- 单元测试
测试单个单元。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。