Accueil › Node.js › Des tests qui ne mentent pas
Des tests qui ne mentent pas
Tester une APIavance
Un test qui échoue une fois sur vingt est pire qu'un test absent. Le test absent laisse un trou connu ; le test instable apprend à l'équipe que les échecs se relancent. Le jour où un vrai bogue arrive, il reçoit la même réponse : « relance, ça passera ».
Un test n'est jamais instable par malchance. Il dépend de quelque chose qu'il ne maîtrise pas, et cette chose figure dans une liste courte.
Les six sources, et leur correction
| Dépendance non maîtrisée | Symptôme | Correction |
|---|---|---|
| L'horloge | échoue à minuit, ou en changeant d'heure | figer le temps |
| Le hasard | échoue un jour sur dix | injecter une graine |
| L'ordre des tests | échoue lancé seul | chaque test crée ses données |
L'ordre d'un Promise.all |
échoue sous charge | ne rien supposer de l'ordre des effets |
| Un port fixe | EADDRINUSE en parallèle |
port éphémère |
| Une attente de durée fixe | échoue sur machine lente | attendre une condition |
L'horloge, figée
import test, { mock } from "node:test";
import assert from "node:assert/strict";
test("un jeton expire après quinze minutes", () => {
mock.timers.enable({ apis: ["Date"], now: new Date("2024-05-02T10:00:00Z") });
const jeton = creerJeton({ dureeMinutes: 15 });
mock.timers.tick(16 * 60 * 1000);
assert.equal(estExpire(jeton), true);
mock.timers.reset();
});
Le test décide quelle heure il est, puis avance le temps lui-même. Sans cela, la seule façon de tester une expiration de quinze minutes serait d'attendre quinze minutes — ou de ne pas la tester.
Les termes à connaître
- Test instable
Un test qui passe ou échoue sans que le code change. Sa cause est toujours une dépendance non maîtrisée : horloge, hasard, ordre, port, durée.
- Horloge figée
mock.timersdenode:testremplaceDateet les minuteurs. Le test décide quelle heure il est, et avance le temps lui-même.- Graine
La valeur qui rend une suite pseudo-aléatoire reproductible. Sans graine injectable, un test qui dépend du hasard échoue un jour sur dix.
- Promise.all
Il préserve l'ordre des résultats, pas celui des exécutions. Deux écritures lancées ensemble arrivent dans un ordre non garanti.
- Attente conditionnelle
Attendre qu'une condition devienne vraie, en réessayant jusqu'à un délai maximal. Remplace l'attente d'une durée fixe.
- Test mis en quarantaine
Un test instable sorti de la suite principale, avec une date. Mieux qu'une relance automatique, qui apprend à l'équipe à ignorer les échecs.
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.