Exercice 7 / 7Moyen
Test d'intégration HTTP (façon supertest)
À toi
Construis une mini-API Express :
GET /api/health→200 { status: "ok" }POST /api/echo→200 { tu_as_envoye: <body> }(renvoie le body reçu)GET /api/users/:id:- Si
idparsé enNumberestNaN→400 { error: "id invalide" } - Si
idest42→200 { id: 42, prenom: "Léa" } - Sinon →
404 { error: "user introuvable" }
- Si
Les tests utilisent request(method, path, opts?) (équivalent supertest dans la sandbox).
Tests d'intégration HTTP
Jusque-là on testait des fonctions pures. Pour une API, il faut tester toute la stack : routing, parsing, middlewares, handler, sérialisation. C'est ce que fait un test d'intégration HTTP.
L'outil standard : supertest
En vrai projet Node :
const request = require("supertest");
const app = require("./app");
test("GET /health", async () => {
const res = await request(app).get("/health");
expect(res.status).toBe(200);
expect(res.body).toEqual({ status: "ok" });
});
Supertest démarre l'app sans écouter sur un port et envoie des requêtes en mémoire. Pas de réseau, pas de port disponible à gérer, pas d'effets de bord.
Dans la sandbox jsbaby
L'API est presque la même : tu disposes de request(method, path, opts?) :
await request("GET", "/api/health");
await request("POST", "/api/users", {
body: { prenom: "Léa" },
headers: { "content-type": "application/json" }
});
Réponse :
res.status— le code HTTPres.body— le body parsé en objet JS
Unit vs intégration : que choisir ?
| Type | Teste | Vitesse | Confiance |
|---|---|---|---|
| Unit | Une fonction isolée | Rapide | API réelle ? |
| Intégration | Plusieurs couches ensemble | Moyen | Très bonne |
| E2E | Full stack avec vraie BDD | Lent | Maximum |
La pyramide de tests : beaucoup d'unit (logique métier), un peu d'intégration (routes critiques), quelques E2E (parcours utilisateur). Pas l'inverse.
Bonnes pratiques
- Un test = une intention. Un test pour le 200, un autre pour le 400, un autre pour le 404. Pas de gros test qui fait 12 assertions différentes.
- Reset l'état entre les tests si tu mutes une vraie BDD ou un store en mémoire.
- Pas de timing flaky : pas de
sleep(100), attends explicitement (await, événements).
Tu es bloqué ?
Ouvre les indices un par un, le corrigé en dernier.
Indice 1
Couvre les 3 cas d'un endpoint dans 3 tests séparés (la règle de l'art : un test, une intention).
Indice 2
Number.isNaN(Number(req.params.id)) pour détecter un id non numérique.
Indice 3
Les tests d'intégration testent toute la stack : routing + parsing + handler. C'est plus lent mais plus représentatif.
Voir le corrigé
Connecte-toi pour voir le corrigé
C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.
Le site garde ton nom et ton email, rien d'autre. Tes données
Pour revoir la notion : chapitre 14 du cours JavaScript, Tester avec Vitest et passer à TypeScript.
Connecte-toi pour faire cet exercice
C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.
Le site garde ton nom et ton email, rien d'autre. Tes données