Formations — 1 037 leçons en français

Accueil › React › Tester ce que voit l'utilisateur

Tester ce que voit l'utilisateur

Tester une application Reactavance

La hiérarchie des requêtes

Testing Library classe ses requêtes par fidélité à l'expérience réelle. On descend d'un cran seulement quand le cran précédent est impossible.

// 1. le rôle, avec son nom accessible — à viser par défaut
screen.getByRole("button", { name: "Ajouter au panier" });
screen.getByRole("heading", { name: /commande n° 42/i });

// 2. le libellé, pour les champs de formulaire
screen.getByLabelText("Adresse e-mail");

// 3. le texte visible, pour ce qui n'a ni rôle ni libellé
screen.getByText("Votre panier est vide");

// 4. l'attribut de test — dernier recours
screen.getByTestId("ligne-facture-3");

Chaque niveau vérifie moins que le précédent. getByRole atteste à la fois qu'un bouton existe, qu'il est annoncé sous le nom attendu, et donc qu'il est utilisable au clavier et par un lecteur d'écran. getByTestId n'atteste que la présence d'un attribut que vous avez écrit pour vous-même.

getBy, queryBy, findBy

// présent maintenant
expect(screen.getByRole("list")).toBeInTheDocument();

// absent — la seule variante possible
expect(screen.queryByRole("alert")).not.toBeInTheDocument();

// présent plus tard
expect(await screen.findByText("3 résultats")).toBeInTheDocument();

Trois usages, trois variantes, et aucune interchangeable. getBy lève quand il ne trouve pas : impossible d'affirmer une absence avec lui. queryBy ne réessaie pas : inutilisable pour attendre. findBy réessaie jusqu'à son délai : à réserver à ce qui est réellement asynchrone, sinon chaque test attend pour rien.

user-event plutôt que fireEvent

const user = userEvent.setup();

await user.click(screen.getByRole("button", { name: "Vider" }));
await user.type(screen.getByLabelText("Quantité"), "3");
await user.selectOptions(screen.getByLabelText("Ville"), "Lyon");

fireEvent.click envoie un seul click. user.click envoie la séquence complète qu'un vrai clic produit, et refuse d'agir sur un élément désactivé ou masqué — ce que ferait aussi un utilisateur, qui ne peut pas cliquer sur un bouton invisible.

Les termes à connaître

Rôle

Ce qu'un élément est pour les technologies d'assistance — button, link, textbox, heading. Un <button> a le rôle button sans qu'on l'écrive.

Nom accessible

Le libellé qu'une technologie d'assistance annonce pour un élément. Il vient dans l'ordre de aria-label, puis aria-labelledby, puis le contenu textuel, puis title.

getBy

Cherche maintenant, lève une exception si rien ne correspond — ou si plusieurs éléments correspondent. L'exception affiche le HTML rendu.

queryBy

Cherche maintenant, rend null si rien ne correspond. C'est la seule variante utilisable pour affirmer qu'un élément est absent.

findBy

Rend une promesse et réessaie jusqu'à trouver, ou jusqu'au délai d'attente. Pour ce qui apparaît après une réponse réseau ou un changement d'état différé.

user-event

Simule un utilisateur : un clic devient un enchaînement de pointerdown, mousedown, focus, mouseup, click. Chaque méthode rend une promesse.

getByTestId

Cherche un attribut data-testid. Dernier recours : il n'existe que pour le test, donc il ne vérifie rien de ce que l'utilisateur perçoit.

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.