test-runner

跨语言与框架编写并运行测试。

框架选型

按框架快速上手

Vitest（TypeScript / JavaScript）

npm install -D vitest @testing-library/react @testing-library/jest-dom

// vitest.config.ts
import { defineConfig } from 'vitest/config'
export default defineConfig({
  test: {
    globals: true,
    environment: 'jsdom',
    setupFiles: './tests/setup.ts',
  },
})

npx vitest              # 监听模式（Watch mode）
npx vitest run          # 单次执行（Single run）
npx vitest --coverage   # 启用覆盖率统计

Jest

npm install -D jest @types/jest ts-jest

npx jest                # 运行全部测试
npx jest --watch        # 监听模式（Watch mode）
npx jest --coverage     # 启用覆盖率统计
npx jest path/to/test   # 运行指定文件

pytest（Python）

uv pip install pytest pytest-cov pytest-asyncio httpx

pytest                          # 运行全部测试
pytest -v                       # 详细输出（Verbose）
pytest -x                       # 首次失败即停止（Stop on first failure）
pytest --cov=app                # 启用覆盖率统计（覆盖 app 模块）
pytest tests/test_api.py -k "test_login"  # 运行匹配名称的特定测试
pytest --tb=short               # 简化堆栈跟踪（Short tracebacks）

XCTest（Swift）

swift test                      # 运行全部测试
swift test --filter MyTests     # 运行指定测试套件
swift test --parallel           # 并行执行

Playwright（E2E）

npm install -D @playwright/test
npx playwright install

npx playwright test                    # 运行全部测试
npx playwright test --headed           # 显示浏览器界面（With browser visible）
npx playwright test --debug            # 调试模式（Debug mode）
npx playwright test --project=chromium # 指定浏览器（如 Chromium）
npx playwright show-report             # 查看 HTML 测试报告

TDD 工作流

1. 红（Red） — 编写一个描述预期行为但当前失败的测试。
2. 绿（Green） — 编写最少必要代码，使该测试通过。
3. 重构（Refactor） — 在确保所有测试仍能通过的前提下优化代码结构。

┌─────────┐     ┌─────────┐     ┌──────────┐
│  编写    │────▶│  编写    │────▶│  重构    │──┐
│  测试    │     │  代码    │     │  代码    │  │
│ （红）   │     │ （绿）   │     │          │  │
└─────────┘     └─────────┘     └──────────┘  │
     ▲                                          │
     └──────────────────────────────────────────┘

常用测试模式

Arrange-Act-Assert（准备-执行-断言）

test('calculates total with tax', () => {
  // Arrange（准备）
  const cart = new Cart([{ price: 100, qty: 2 }]);

  // Act（执行）
  const total = cart.totalWithTax(0.08);

  // Assert（断言）
  expect(total).toBe(216);
});

异步代码测试

test('fetches user data', async () => {
  const user = await getUser('123');
  expect(user.name).toBe('Colt');
});

Mock（模拟）

import { vi } from 'vitest';

const mockFetch = vi.fn().mockResolvedValue({
  json: () => Promise.resolve({ id: 1, name: 'Test' }),
});
vi.stubGlobal('fetch', mockFetch);

API 接口测试（Python）

import pytest
from httpx import AsyncClient
from app.main import app

@pytest.mark.asyncio
async def test_get_users():
    async with AsyncClient(app=app, base_url="http://test") as client:
        response = await client.get("/users")
    assert response.status_code == 200
    assert isinstance(response.json(), list)

React 组件测试

import { render, screen, fireEvent } from '@testing-library/react';
import { Button } from './Button';

test('calls onClick when clicked', () => {
  const handleClick = vi.fn();
  render(Click me);
  fireEvent.click(screen.getByText('Click me'));
  expect(handleClick).toHaveBeenCalledOnce();
});

覆盖率命令

# JavaScript/TypeScript
npx vitest --coverage          # Vitest（默认使用 v8 或 istanbul）
npx jest --coverage            # Jest

# Python
pytest --cov=app --cov-report=html    # 生成 HTML 报告
pytest --cov=app --cov-report=term    # 终端输出覆盖率
pytest --cov=app --cov-fail-under=80  # 覆盖率低于 80% 则构建失败

# 查看 HTML 覆盖率报告
open coverage/index.html       # macOS（Vitest/Jest）
open htmlcov/index.html        # Python（pytest-cov）

应当测试的内容

务必覆盖：

• 公共 API / 导出函数
• 边界场景：空输入、null 值、临界值
• 错误处理：非法输入、网络异常
• 业务逻辑：数值计算、状态转换

无需测试：

• 私有实现细节
• 框架内部机制（如 React 渲染、Express 路由）
• 简单的 getter/setter 方法
• 第三方库自身行为