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 進行元件測試。
- 報告:確保測試為 CI 閘道生成 JSON 涵蓋率報告。目標是核心程式庫達到 80% 以上的涵蓋率。
反模式
- 測試中不應使用真實網路請求:始終使用 MSW 處理器或模擬。
- 不測試實作細節:測試使用者行為,而非內部方法。
- 不對單元邏輯進行大量 E2E 測試:使用 Vitest 進行隔離的邏輯測試。
- 不洩漏全域狀態:在每個測試後重置 MSW 處理器和模擬。
參考資料