Accueil › Vue.js › Tester ce que voit l'utilisateur
Tester ce que voit l'utilisateur
Tester une application Vueavance
Un test de composant a deux façons d'échouer mal : casser quand on renomme une variable, et passer quand l'écran est cassé. Les deux viennent du même choix — interroger l'intérieur du composant au lieu de son rendu.
// Fragile : rien de tout cela n'existe pour l'utilisateur
expect(wrapper.vm.erreurs.length).toBe(1)
expect(wrapper.find('.alert-danger').exists()).toBe(true)
// Robuste : exactement ce que la personne voit
expect(screen.getByRole('alert')).toHaveTextContent('Adresse invalide')
La règle tient en une phrase : plus un test ressemble à la façon dont le logiciel est utilisé, plus il inspire confiance. On agit par l'interface — cliquer, saisir, soumettre — et on vérifie par l'interface — un texte apparu, un bouton désactivé, une ligne disparue.
const utilisateur = userEvent.setup()
render(FormulaireAdresse)
await utilisateur.type(screen.getByLabelText('Code postal'), '750')
await utilisateur.click(screen.getByRole('button', { name: 'Valider' }))
expect(await screen.findByRole('alert')).toBeTruthy()
Aucune de ces lignes ne connaît le nom d'une ref, la structure des enfants ni
une classe CSS. On peut réécrire entièrement l'intérieur du formulaire : le
test décrit toujours la même exigence.
Les termes à connaître
- Détail d'implémentation
Tout ce qu'un utilisateur ne peut pas percevoir : le nom d'une variable interne, la structure des composants enfants, une classe CSS technique. Un test qui s'y accroche casse à la première refonte sans régression.
- Rôle accessible
Le rôle ARIA qu'un élément expose à la technologie d'assistance, implicite pour les balises natives :
buttonpour<button>,textboxpour<input type="text">,headingpour<h1>.- Nom accessible
Le libellé qu'une technologie d'assistance annonce pour un élément. Il vient du texte interne, d'un
<label>associé, d'unaria-labelou d'unaria-labelledby.- getByRole
La requête de plus haute priorité. Elle sélectionne par rôle et, avec l'option
name, par nom accessible — donc exactement par ce qui identifie l'élément pour l'utilisateur.- userEvent
La bibliothèque qui simule une interaction complète : un clic comporte un survol, un enfoncement, un relâchement et le focus. Elle est plus proche du navigateur que
fireEvent, qui envoie un seul événement.- data-testid
Un attribut dédié au test, cible de
getByTestId. C'est la requête de dernier recours, à employer quand aucun rôle ni texte stable n'identifie l'élément.- Test fragile
Un test qui échoue pour une modification sans effet sur l'utilisateur, ou qui passe malgré une régression réelle. Les deux défauts ont la même cause : l'assertion ne porte pas sur le comportement observable.
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.