Skip to content

高级单元测试模式

中等 约 40 分钟

你将构建什么

一个字符串工具模块的综合测试套件,使用参数化测试、自定义匹配器和 beforeEach/afterEach 钩子实现干净的测试隔离。

学习目标

  • 编写参数化/数据驱动测试
  • 创建自定义 Jest/Vitest 匹配器
  • 有效使用 setup 和 teardown 钩子
  • 测试边界条件和极端情况

前置要求

  • 基本测试语法(describe、it、expect)
  • 断言和匹配器
  • JavaScript/TypeScript 函数

步骤

  1. 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. 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. 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. 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. 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...');
      });
    });

    预期结果

    所有边界用例通过,确认函数正确处理边界输入。

自己动手试试

你学到了什么

你掌握了高级测试模式 —— 用于覆盖的参数化测试、用于可读性的自定义匹配器、用于隔离的钩子,以及用于健壮性的边界测试。这些技术可扩展到大型测试套件。

相关资源

相关课程

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题