Formations — 1 037 leçons en français

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.timers de node:test remplace Date et 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.

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.