Formations — 1 037 leçons en français

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 : button pour <button>, textbox pour <input type="text">, heading pour <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'un aria-label ou d'un aria-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.

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.