Formations — 1 037 leçons en français

Accueil › Node.js › Quoi tester, et à quel niveau

Quoi tester, et à quel niveau

Tester une APIavance

Node exécute vos tests lui-même. Aucune dépendance.

// tarif.test.js
import test from "node:test";
import assert from "node:assert/strict";

import { calculerTarif } from "./tarif.js";

test("applique la remise au-delà de dix articles", () => {
  assert.equal(calculerTarif({ prix: 100, quantite: 12 }), 1080);
});
node --test                  # découvre *.test.js et les lance
node --test --watch          # relance à chaque enregistrement

Deux niveaux, deux raisons d'exister

Un test unitaire appelle une fonction et vérifie ce qu'elle renvoie. Il convient à la logique pure : calcul de prix, validation d'un corps de requête, décision d'autorisation. Ces fonctions ont beaucoup de cas et aucune dépendance — les tester une par une coûte quelques millisecondes.

Un test d'API envoie une requête à l'application complète et vérifie la réponse. Il convient au chemin entier, parce que c'est là que ça casse : un intergiciel oublié, un corps sérialisé avec le mot de passe dedans, un 200 renvoyé là où un 201 est attendu. Aucun de ces trois bogues n'est visible depuis une fonction prise seule.

La question à se poser

Le bogue apparaîtrait… Donc
dans le résultat d'une fonction test unitaire
dans le statut, un en-tête, la forme du corps test d'API
dans l'enchaînement des intergiciels test d'API
nulle part : c'est un détail d'implémentation pas de test

Le dernier cas compte autant que les autres. Un test qui vérifie qu'une fonction privée a bien été appelée fixe l'implémentation et interdit de la changer.

Les termes à connaître

node --test

L'exécuteur de tests intégré à Node. Il découvre les fichiers, exécute les suites, affiche un rapport. Aucune dépendance à installer.

Test unitaire

Il appelle une fonction et vérifie sa valeur de retour. Pas de serveur, pas de base. Il est rapide parce qu'il ne traverse rien.

Test d'API

Il envoie une requête HTTP à l'application entière et vérifie le statut, les en-têtes et le corps de la réponse.

Logique pure

Une fonction dont le résultat ne dépend que de ses arguments — calcul de prix, validation, décision d'autorisation. C'est le terrain naturel du test unitaire.

Pyramide des tests

Beaucoup de tests unitaires, moins de tests d'API, très peu de tests de bout en bout par le navigateur. Une question de coût, pas de dogme.

Couverture

La proportion de lignes exécutées par les tests. node --test --experimental-test-coverage la mesure. Elle dit ce qui n'est jamais exécuté, rien de plus.

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.