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
.vuedu projet sans configuration séparée.- environment
L'option Vitest qui choisit le monde dans lequel le test s'exécute :
nodepar défaut,jsdomouhappy-dompour obtenir undocumentet 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/vuequi monte un composant dans ledocumentet renvoie des requêtes limitées à ce rendu, plusrerenderetunmount.- screen
Un objet de requêtes porté sur
document.bodyentier. On le préfère au retour derenderparce 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
wrapperet l'instance du composant. Elle exposevm,setData,findpar 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/vuel'enregistre automatiquement quand unafterEachglobal existe, ce que donne l'optionglobalsde Vitest.
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.