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ôlebuttonsans 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, puisaria-labelledby, puis le contenu textuel, puistitle.- 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
nullsi 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.
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.