Formations — 1 037 leçons en français

Accueil › React › Simuler l'API

Simuler l'API

Tester une application Reactavance

Un intercepteur partagé

// src/testsApi.js
import { setupServer } from "msw/node";
import { http, HttpResponse } from "msw";

export const gestionnaires = [
  http.get("/api/clients", () =>
    HttpResponse.json([
      { id: 1, nom: "Dupont" },
      { id: 2, nom: "Martin" },
    ]),
  ),
  http.get("/api/clients/:id", ({ params }) =>
    HttpResponse.json({ id: Number(params.id), nom: "Dupont" }),
  ),
];

export const server = setupServer(...gestionnaires);
// src/setupTests.js
beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
afterEach(() => server.resetHandlers());
afterAll(() => server.close());

Les gestionnaires par défaut décrivent le scénario heureux, une fois pour tout le projet. Chaque test n'écrit que ce qui s'en écarte.

Le composant ne sait rien

test("affiche les clients chargés", async () => {
  render(<ListeClients />);

  expect(screen.getByText("Chargement…")).toBeInTheDocument();
  expect(await screen.findByText("Dupont")).toBeInTheDocument();
  expect(screen.getByText("Martin")).toBeInTheDocument();
});

Aucune ligne ne mentionne fetch, ni MSW, ni une promesse. Le composant garde son vrai code d'appel — URL, méthode, en-têtes, lecture de la réponse — et c'est ce code qui est exercé. Un fetch remplacé par une fonction simulée, lui, répondrait la même chose même si l'URL était fautive.

Le cas d'erreur, test par test

test("affiche un message quand le serveur tombe", async () => {
  server.use(
    http.get("/api/clients", () => new HttpResponse(null, { status: 500 })),
  );

  render(<ListeClients />);

  expect(await screen.findByRole("alert")).toHaveTextContent(/réessayer/i);
});

server.use n'écrase les gestionnaires que pour ce test, et resetHandlers remet l'état initial après. C'est ce couple qui rend les tests indépendants de leur ordre d'exécution.

Les termes à connaître

MSW

Mock Service Worker. Il intercepte les requêtes au niveau de la couche réseau, pas au niveau du code : le composant appelle fetch normalement et ne sait pas qu'il est testé.

setupServer

La fonction de msw/node qui crée l'intercepteur utilisé en test. Elle reçoit la liste des gestionnaires par défaut, ceux du scénario heureux.

Gestionnaire

Une règle méthode + motif d'URL → réponse, écrite http.get("/api/clients/:id", resolveur). Le motif accepte des segments nommés.

server.use

Ajoute un gestionnaire prioritaire pour le test en cours. C'est ainsi qu'on provoque un 500 ou une réponse vide sans toucher aux gestionnaires par défaut.

resetHandlers

Remet les gestionnaires par défaut entre deux tests. Sans cet appel, le 500 ajouté par un test contamine tous les suivants.

onUnhandledRequest

Le comportement devant une requête qu'aucun gestionnaire ne couvre. Réglé sur "error", il transforme une URL oubliée en échec immédiat au lieu d'un test qui attend dans le vide.

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.