Accueil › React › Vitest et Testing Library
Vitest et Testing Library
Tester une application Reactavance
Le socle
Trois paquets, et ils ont chacun un rôle distinct.
npm i -D vitest jsdom @testing-library/react @testing-library/user-event @testing-library/jest-dom
vitest lance les tests, jsdom fournit un DOM, @testing-library/react monte
les composants dedans. user-event simule les interactions, jest-dom ajoute
les assertions lisibles.
// vite.config.js
export default defineConfig({
test: {
environment: "jsdom",
globals: true,
setupFiles: "./src/setupTests.js",
},
});
// src/setupTests.js
import "@testing-library/jest-dom/vitest";
Vitest réutilise la configuration de Vite : vos alias d'import et votre transformation JSX sont déjà là.
Un premier test
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import Panier from "./Panier";
test("affiche le total des lignes", () => {
render(<Panier lignes={[{ id: 1, prix: 10 }, { id: 2, prix: 5 }]} />);
expect(screen.getByText("15 €")).toBeInTheDocument();
});
test("vide le panier au clic", async () => {
const user = userEvent.setup();
render(<Panier lignes={[{ id: 1, prix: 10 }]} />);
await user.click(screen.getByRole("button", { name: "Vider" }));
expect(screen.getByText("Votre panier est vide")).toBeInTheDocument();
});
Trois temps, toujours les mêmes : on rend, on agit, on vérifie. Aucune ligne ne nomme un état interne, une classe CSS ni un composant enfant — seulement ce qui apparaît à l'écran et ce qu'un utilisateur ferait.
Ce qui distingue ce test d'un test unitaire
Il ne vérifie pas que calculerTotal rend 15. Il vérifie que l'utilisateur
voit 15 €. Entre les deux, il y a le rendu, le formatage, la condition
d'affichage et le branchement des props — soit la plupart des bogues réels.
Les termes à connaître
- Vitest
Le lanceur de tests. Il lit la configuration de Vite, donc vos alias d'import et vos transformations JSX fonctionnent sans être redéclarés.
- jsdom
Une implémentation de DOM en JavaScript, exécutée hors navigateur. Elle fournit
documentetwindowà Vitest, mais ne peint rien : il n'y a ni mise en page ni pixels.- @testing-library/react
Le pont entre React et le DOM de test. Il fournit
render, qui monte un composant, etscreen, qui interroge le document rendu.- screen
L'objet qui porte toutes les requêtes, liées à
document.body. Le préférer au retour derenderévite de déstructurer une liste de requêtes à chaque test.- @testing-library/jest-dom
Un jeu d'assertions sur des éléments du DOM —
toBeInTheDocument,toBeDisabled,toHaveValue. Sans lui, on compare des propriétés à la main et les messages d'échec n'expliquent rien.- Nettoyage
Le démontage du composant entre deux tests. Testing Library l'enregistre dans un
afterEachautomatique dès que l'environnement expose les hooks de test globalement.
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.