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
TRUNCATEdes 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.
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.