Next.js Testing
Priorität: P1 (HOCH)
Struktur
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # MSW Handler
Implementierungsrichtlinien
- Unit-Tests: Verwende Vitest für Geschwindigkeit und React Testing Library (RTL) für das Komponentenverhalten. Folge dem Arrange-Act-Assert (AAA)-Muster.
- E2E-Tests: Verwende Playwright für die Full-Stack-Validierung des App Router. Konzentriere dich auf Benutzerflüsse (z. B. Login, Checkout).
- Netzwerk: Mocke alle internen/externen API-Grenzen mit Mock Service Worker (MSW). Stelle sicher, dass
server- und browser-Handler korrekt konfiguriert sind.
- RSC-Tests: Teste React Server Components (RSC) mit denselben Mustern wie Bibliotheken (SSR-kompatible Tests). Bevorzuge E2E-Tests für komplexe asynchrone Datenabruflogik.
- Interaktionen: Verwende
userEvent (async), um Benutzeraktionen zu simulieren: await user.click(button).
- Selektoren: Bevorzuge
getByRole / findByRole, um die Barrierefreiheit zu testen. Verwende data-testid nur als Fallback.
- Umgebung: Konfiguriere
vitest.config.ts mit jsdom oder happy-dom für Komponententests.
- Berichterstattung: Stelle sicher, dass Tests JSON-Abdeckungsberichte für CI-Gates generieren. Strebe 80 %+ Abdeckung in Kernbibliotheken an.
Anti-Patterns
- Keine echte Netzwerknutzung in Tests: Verwende immer MSW-Handler oder Mocks.
- Kein Testen der Implementierung: Teste das Benutzerverhalten, nicht interne Methoden.
- Keine schweren E2E-Tests für Unit-Logik: Verwende Vitest für isolierte Logiktests.
- Kein Verlust des globalen Zustands: Setze MSW-Handler und Mocks nach jedem Test zurück.
Referenzen