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-coveragela mesure. Elle dit ce qui n'est jamais exécuté, rien de plus.
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.