Formations — 1 037 leçons en français

Accueil › Vue.js › Vitest et Testing Library

Vitest et Testing Library

Tester une application Vueavance

Vitest est le lanceur de tests qui réutilise la configuration de Vite. Les alias, les variables d'environnement, le greffon Vue : tout ce que connaît votre build, les tests le connaissent aussi. Il n'y a pas de seconde chaîne de transformation à maintenir.

// vite.config.ts
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  test: {
    environment: 'jsdom',
    globals: true,
  },
})

environment: 'jsdom' fournit un document, sans lequel aucun composant ne peut être monté. globals: true expose describe, it et expect sans import — et, effet moins connu, permet à Testing Library d'enregistrer son nettoyage automatique après chaque test.

import { render, screen } from '@testing-library/vue'
import { describe, it, expect } from 'vitest'
import Panier from './Panier.vue'

describe('Panier', () => {
  it('affiche le nombre de lignes', () => {
    render(Panier, { props: { lignes: [{ id: 1 }, { id: 2 }] } })
    expect(screen.getByText('2 articles')).toBeTruthy()
  })
})

render monte le composant dans un vrai document. screen interroge ensuite ce document comme le ferait un utilisateur : par texte, par libellé, par rôle. Aucune ligne ne touche à l'instance du composant.

Les termes à connaître

Vitest

Le lanceur de tests qui réutilise la configuration et la chaîne de transformation de Vite. Il comprend donc les alias, les variables d'environnement et les fichiers .vue du projet sans configuration séparée.

environment

L'option Vitest qui choisit le monde dans lequel le test s'exécute : node par défaut, jsdom ou happy-dom pour obtenir un document et pouvoir rendre des composants.

Testing Library

Une famille de bibliothèques qui expose un composant rendu par ses éléments visibles — rôles, libellés, textes — au lieu de son instance interne. Le paquet Vue est @testing-library/vue.

render

La fonction de @testing-library/vue qui monte un composant dans le document et renvoie des requêtes limitées à ce rendu, plus rerender et unmount.

screen

Un objet de requêtes porté sur document.body entier. On le préfère au retour de render parce qu'il retrouve aussi ce qui est téléporté hors du conteneur.

@vue/test-utils

La bibliothèque de test officielle de Vue, centrée sur le wrapper et l'instance du composant. Elle expose vm, setData, find par sélecteur CSS — utile pour les cas où l'on teste délibérément l'intérieur.

Nettoyage entre tests

La destruction des composants montés après chaque test. @testing-library/vue l'enregistre automatiquement quand un afterEach global existe, ce que donne l'option globals de Vitest.

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.