Tests du nouveau front
| Niveau | Outil | Ce qui est vérifié | Commande |
|---|---|---|---|
| Fonctions pures | Vitest | formatage, paramètres d'URL, tokens et contrastes | pnpm --filter <package> test |
| Composants | Vitest + Testing Library | ce que voit l'utilisateur : rôles et libellés accessibles, clavier | pnpm --filter @clair/ui test |
| Stories des composants | Storybook + Vitest (Chromium) + axe | chaque story s'affiche sans erreur ni violation d'accessibilité ; sa fonction play rejoue le comportement (clic, clavier, focus) | pnpm --filter @clair/storybook test:stories |
| Écrans | Vitest + fixtures | états chargement, vide, erreur, succès ; URL mise à jour par les filtres | pnpm --filter @clair/screens test |
| Stories des écrans | Storybook + Vitest (Chromium) + axe | chaque écran rendu sur ses fixtures, dans tous ses états, en mobile et en sombre, sans violation d'accessibilité ; play vérifie le titre et une interaction | pnpm --filter @clair/storybook test:stories |
| Parcours | Playwright + axe | site : chaque grande rubrique répond, a un titre de niveau 1, aucune erreur ni violation d'accessibilité grave ; documentation : pages de la section Front | pnpm test:e2e --project=site (ou docs) |
Règle : on teste ce que voit l'utilisateur (getByRole, libellés), pas les classes CSS.
Stories des écrans
Chaque écran de packages/screens a sa story, <Xxx>Screen.stories.tsx, titrée Écrans/…. Elle reprend les fixtures fictives de son test. Le décorateur withApi de l'atelier (apps/storybook/.storybook/preview.tsx) lit les paramètres de la story et répond à la place de l'API, sans réseau :
Code
Le test du catalogue (packages/screens/src/catalogue.test.ts) refuse un écran sans story Defaut, Mobile et Sombre, ni fonction play. Celui des composants (packages/ui/src/catalogue.test.ts) refuse un composant sans story Defaut.
Couverture
pnpm test:coverage mesure la couverture de chaque paquet du front (Vitest et @vitest/coverage-v8), hors stories, tests et fixtures. Chaque paquet a son seuil dans son vitest.config.ts, juste sous le niveau mesuré : un changement qui fait baisser la couverture échoue, et le seuil se remonte quand la couverture monte. Le rapport HTML est écrit dans packages/<paquet>/coverage/, ignoré par git.
Tests e2e du site
e2e/site.fumee.spec.ts vérifie le site construit (pnpm --filter @clair/site build), servi par next start sur le port 4310. Le site y parle à un faux serveur d'API (e2e/fake-api.mjs, port 4312) : listes vides, fiches en 404, aucune donnée parlementaire réelle ou inventée. Les requêtes vers l'extérieur (formulaire de don, photos des assemblées) sont coupées. Le job e2e-site de la CI les lance à chaque pull request ; il ne construit pas la documentation, dont le build télécharge la spécification OpenAPI de production.
Une nouvelle rubrique portée s'ajoute à la liste RUBRIQUES du test ; si son écran appelle une route que le faux serveur ne connaît pas encore, l'y ajouter avec la forme de réponse de packages/data.