Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.