Accueil › React › Les tests fragiles
Les tests fragiles
Tester une application Reactavance
La question à se poser avant chaque assertion
« Si je réécris ce composant sans changer ce que l'utilisateur voit, cette ligne tient-elle ? » Si la réponse est non, l'assertion teste l'implémentation.
// ❌ fragile : classe CSS, index d'enfant, sélecteur de structure
expect(container.querySelector(".ligne-active")).toBeTruthy();
expect(container.children[2].textContent).toBe("Dupont");
expect(container.querySelectorAll(".ligne-client")).toHaveLength(3);
// ✅ robuste : rôle, nom accessible, texte visible, état annoncé
expect(screen.getByRole("row", { name: /Dupont/ })).toBeInTheDocument();
expect(screen.getAllByRole("row")).toHaveLength(4);
expect(screen.getByRole("button", { name: "Détails" }))
.toHaveAttribute("aria-expanded", "true");
Les trois premières dépendent de décisions internes : un nom de classe, une position dans le DOM, un découpage en composants. Les trois suivantes dépendent de ce qui est rendu perceptible.
Pourquoi le test qui connaît la structure casse au premier remaniement
Un test couplé à l'implémentation ne vérifie pas le comportement : il recopie le code sous une autre forme. Dès qu'on extrait un sous-composant, qu'on renomme une classe ou qu'on insère un conteneur pour la mise en page, il devient rouge alors que rien n'a changé à l'écran.
Le coût n'est pas le temps de correction. C'est la perte de confiance : au troisième échec sans cause réelle, l'équipe cesse de lire les messages et revalide par réflexe. La suite devient un péage, et le jour où elle signale un vrai bogue, personne ne le croit.
Et le défaut inverse
<div className="btn" data-testid="enregistrer" onClick={envoyer}>Enregistrer</div>
getByTestId("enregistrer") reste vert. Le bouton n'est plus atteignable au
clavier, n'est plus annoncé comme un bouton, et aucun test ne le dit. Un test
fragile crie pour rien ; un test trop permissif se tait quand il faudrait
crier.
Les termes à connaître
- Test fragile
Un test qui échoue alors que le comportement est intact. Il consomme du temps à chaque remaniement et finit par être désactivé — ou lu sans être cru.
- Couplage à l'implémentation
Une assertion qui dépend de la façon dont le composant est écrit — un nom de classe, un index d'enfant, un composant interne — plutôt que de ce qu'il produit.
- Détail d'implémentation
Tout ce que l'utilisateur ne peut ni voir ni atteindre : l'état interne, le découpage en sous-composants, l'ordre des appels. Il doit pouvoir changer sans test rouge.
- Test instable
Un test qui passe ou échoue selon la charge de la machine. Presque toujours une attente arbitraire, ou une absence d'attente.
- Instantané
Une capture du HTML rendu, comparée aux exécutions suivantes. Large, il échoue à chaque changement de balise et finit par être revalidé sans lecture.
- Remaniement
Changer la structure interne sans changer le comportement. C'est l'épreuve de vérité d'une suite de tests : elle doit rester verte.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.