Aller au contenu
Réussir mon BTS SIO

Tape une notion, une commande ou le nom d'une épreuve.

Par exemple

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 id parsé en Number est NaN → 400 { error: "id invalide" }
    • Si id est 42 → 200 { id: 42, prenom: "Léa" }
    • Sinon → 404 { error: "user introuvable" }

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 :

javascript
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?) :

javascript
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 HTTP
  • res.body — le body parsé en objet JS

Unit vs intégration : que choisir ?

TypeTesteVitesseConfiance
UnitUne fonction isoléeRapideAPI réelle ?
IntégrationPlusieurs couches ensembleMoyenTrès bonne
E2EFull stack avec vraie BDDLentMaximum

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).
Ton code

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