Next.js テスト
優先度: P1 (高)
構造
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # MSW ハンドラー
実装ガイドライン
- ユニットテスト: 高速な Vitest とコンポーネント動作のための React Testing Library (RTL) を使用します。Arrange-Act-Assert (AAA) パターンに従います。
- E2E テスト: フルスタック App Router の検証に Playwright を使用します。ユーザーフロー(例:ログイン、チェックアウト)に焦点を当てます。
- ネットワーキング: Mock Service Worker (MSW) を使用して、すべての内部/外部 API 境界をモックします。
server および browser ハンドラー が正しく設定されていることを確認します。
- RSC テスト: React Server Components (RSC) を、ライブラリと同じパターン(SSR 互換テスト)でテストします。複雑な非同期データ取得ロジックには、E2E テスト を優先します。
- インタラクション:
userEvent (非同期) を使用してユーザーアクションをシミュレートします:await user.click(button)。
- セレクタ: アクセシビリティをテストするために
getByRole / findByRole を優先します。data-testid は最終手段としてのみ使用します。
- 環境: コンポーネントテスト用に
vitest.config.ts を jsdom または happy-dom で設定します。
- レポーティング: CI ゲート用にテストが JSON カバレッジレポート を生成することを確認します。コアライブラリで 80% 以上のカバレッジ を目指します。
アンチパターン
- テストでの実際のネットワーク使用禁止: 常に MSW ハンドラーまたはモックを使用します。
- 実装のテスト禁止: 内部メソッドではなく、ユーザーの動作をテストします。
- ユニットロジックへの重い E2E テスト禁止: 孤立したロジックのテストには Vitest を使用します。
- グローバル状態の漏洩禁止: 各テストの後に MSW ハンドラーとモックをリセットします。
参考