Next.js 测试
优先级:P1(高)
结构
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # MSW 处理器
实现指南
- 单元测试:使用 Vitest 以获得速度,并使用 React Testing Library (RTL) 测试组件行为。遵循 Arrange-Act-Assert(AAA) 模式。
- E2E 测试:使用 Playwright 进行完整的 App Router 验证。重点关注 用户流程(例如登录、结账)。
- 网络模拟:使用 Mock Service Worker (MSW) 模拟所有内部/外部 API 边界。确保正确配置了
server 和 browser 处理器。
- RSC 测试:使用与库相同的模式(兼容 SSR 的测试)测试 React Server Components (RSC)。对于复杂的异步数据获取逻辑,优先使用 E2E 测试。
- 交互:使用
userEvent(异步) 模拟用户操作:await user.click(button)。
- 选择器:优先使用
getByRole / findByRole 来测试可访问性。仅将 data-testid 作为后备方案使用。
- 环境:在组件测试中,配置
vitest.config.ts 并使用 jsdom 或 happy-dom。
- 报告:确保测试生成 JSON 覆盖率报告 以用于 CI 门控。核心库的覆盖率目标为 80% 以上。
反模式
- 测试中禁止使用真实网络:始终使用 MSW 处理器或模拟。
- 禁止测试实现细节:测试用户行为,而非内部方法。
- 避免对单元逻辑进行繁重的 E2E 测试:使用 Vitest 进行独立的逻辑测试。
- 避免全局状态泄漏:在每个测试后重置 MSW 处理器和模拟。
参考