Formations — 1 037 leçons en français

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 document et window à 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, et screen, qui interroge le document rendu.

screen

L'objet qui porte toutes les requêtes, liées à document.body. Le préférer au retour de render é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 afterEach automatique dès que l'environnement expose les hooks de test globalement.

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.