Tests Next.js
Priorité : P1 (HAUTE)
Structure
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # Gestionnaires MSW
Consignes de mise en œuvre
- Tests unitaires : Utilisez Vitest pour la rapidité et React Testing Library (RTL) pour le comportement des composants. Suivez les modèles Arrange-Act-Assert (AAA).
- Tests E2E : Utilisez Playwright pour la validation complète de App Router. Concentrez-vous sur les parcours utilisateur (par exemple, Connexion, Checkout).
- Réseau : Mockez toutes les frontières API internes/externes à l'aide de Mock Service Worker (MSW). Assurez-vous que les gestionnaires
server et browser sont correctement configurés.
- Tests RSC : Testez les composants serveur React (RSC) en utilisant les mêmes modèles que les bibliothèques (tests compatibles SSR). Préférez les tests E2E pour la logique complexe de récupération de données asynchrones.
- Interactions : Utilisez
userEvent (asynchrone) pour simuler les actions utilisateur : await user.click(button).
- Sélecteurs : Privilégiez
getByRole / findByRole pour tester l'accessibilité. Utilisez data-testid uniquement en dernier recours.
- Environnement : Configurez
vitest.config.ts avec jsdom ou happy-dom pour les tests de composants.
- Rapports : Assurez-vous que les tests génèrent des rapports de couverture JSON pour les portes CI. Visez une couverture de 80 %+ sur les bibliothèques principales.
Anti-patrons
- Pas d'utilisation réseau réelle dans les tests : utilisez toujours les gestionnaires ou mocks MSW.
- Pas de test d'implémentation : testez le comportement utilisateur, pas les méthodes internes.
- Pas de tests E2E lourds pour la logique unitaire : utilisez Vitest pour les tests de logique isolée.
- Pas de fuite d'état global : réinitialisez les gestionnaires et mocks MSW après chaque test.
Références