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
fetchnormalement et ne sait pas qu'il est testé.- setupServer
La fonction de
msw/nodequi 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, écritehttp.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.
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.