Formations — 1 037 leçons en français

Accueil › Node.js › Une base de données de test

Une base de données de test

Tester une APIavance

Une API passe son temps à écrire dans une base. La tester sans base, c'est tester autre chose.

Le double est aveugle

// Ce test passe. Il ne prouve rien.
const base = { inserer: mock.fn(() => ({ id: 1, nom: "Anne" })) };

test("crée un client", async () => {
  const resultat = await creerClient(base, { nom: "Anne", equipeId: 42 });
  assert.equal(resultat.id, 1);
});

Le double renvoie ce que le test lui a demandé de renvoyer. Si equipeId: 42 ne correspond à aucune équipe, la vraie base lèverait une violation de clé étrangère ; le double répond sans broncher. Un double ne reproduit ni les contraintes, ni les transactions, ni les erreurs de clé étrangère — et ce sont précisément ces erreurs qu'on veut attraper.

La base réelle, jetable

# compose.test.yaml — le même moteur qu'en production
services:
  bdd:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: test       # base jetable, aucun secret réel ici
    ports: ["5433:5432"]            # décalé pour ne pas gêner la base locale
docker compose -f compose.test.yaml up -d
npm run migrer                      # le schéma vient des migrations
node --test --env-file=.env.test

Quelques secondes de démarrage, une fois par suite. En échange, les tests voient les mêmes contraintes, les mêmes types et les mêmes codes d'erreur qu'en production — sous PostgreSQL, 23505 pour une unicité violée, 23503 pour une clé étrangère.

Le schéma vient toujours des migrations. Un schéma de test recopié à la main finit par diverger, et les tests valident alors une base qui n'existe nulle part.

Les termes à connaître

Base réelle en conteneur

Le même moteur qu'en production, lancé dans un conteneur jetable pour les tests. Mêmes contraintes, mêmes transactions, mêmes messages d'erreur.

Double de base

Un faux client de base qui renvoie des valeurs décidées par le test. Rapide, et aveugle à tout ce que la base vérifie elle-même.

Isolation par transaction

Chaque test s'exécute dans une transaction annulée à la fin. Rien n'est écrit, et la base revient exactement à son état initial.

Troncature

TRUNCATE des tables entre les tests. Plus simple qu'une transaction, et compatible avec un test qui valide sa propre transaction.

Migration

Le script qui crée le schéma. En test, on l'applique sur une base vide avant la suite.

Fabrique de données

Une fonction qui construit un enregistrement valide à partir de valeurs par défaut et d'un fragment. Le test ne décrit que ce qui le concerne.

Contrainte de clé étrangère

La règle qui interdit de référencer une ligne absente. Un double ne la connaît pas.

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.