测试
单元测试和 E2E 测试指南
测试策略
| 类型 | 工具 | 覆盖目标 |
|---|---|---|
| 单元测试 | Jest + Testing Library | 80%+ 覆盖率 |
| E2E 测试 | Playwright | 核心用户流程 |
运行测试
# E2E 测试
pnpm e2e
# CI 环境 E2E
pnpm e2e:ci单元测试
测试文件放在对应模块的 __tests__/ 目录下，命名为 *.test.ts(x)：
src/features/events/
├── __tests__/
│ └── event-utils.test.ts
├── event-utils.ts
└── index.ts编写示例
import { describe, it, expect } from "@jest/globals";
import { formatEventDate } from "../event-utils";
describe("formatEventDate", () => {
it("should format date correctly", () => {
const date = new Date("2025-07-01T10:00:00Z");
expect(formatEventDate(date)).toBe("2025-07-01 10:00");
});
it("should handle null date", () => {
expect(formatEventDate(null)).toBe("TBD");
});
});E2E 测试
Playwright 测试覆盖核心用户流程：
import { test, expect } from "@playwright/test";
test("user can view events page", async ({ page }) => {
await page.goto("/events");
await expect(page.getByRole("heading", { name: /活动/ })).toBeVisible();
});运行单个测试文件
pnpm exec playwright test tests/events.spec.ts调试模式
pnpm exec playwright test --debug测试最佳实践
- 单元测试关注纯函数和业务逻辑
- E2E 测试关注用户可见的交互流程
- 使用
describe分组相关测试 - 测试命名描述预期行为（
should ...） - 避免测试实现细节，关注输入输出