Accueil › JavaScript › Remplacer ce qui gêne
Remplacer ce qui gêne
Tester son JavaScriptavance
Un test doit être rapide et déterministe. Trois choses l'en empêchent : le réseau, l'horloge, le hasard.
L'injection avant tout
// ❌ intestable sans réseau
async function chargerClients() {
const r = await fetch("/api/clients");
return r.json();
}
// ✅ le test fournit ce qu'il veut
async function chargerClients(lire = lireJson) {
return lire("/api/clients");
}
test("rend la liste reçue", async () => {
const faux = async () => [{ nom: "Anne" }];
expect(await chargerClients(faux)).toEqual([{ nom: "Anne" }]);
});
test("relaie l'erreur du serveur", async () => {
const faux = async () => { throw new Error("HTTP 500"); };
await expect(chargerClients(faux)).rejects.toThrow("HTTP 500");
});
Aucun outillage. Un paramètre avec valeur par défaut, et la fonction est testable sous tous ses angles — y compris l'échec, qui est le plus difficile à provoquer autrement.
L'horloge simulée
import { vi, test, expect } from "vitest";
test("n'appelle qu'une fois pour une rafale", () => {
vi.useFakeTimers();
const espion = vi.fn();
const ralenti = antiRebond(espion, 300);
ralenti(); ralenti(); ralenti();
vi.advanceTimersByTime(299);
expect(espion).not.toHaveBeenCalled();
vi.advanceTimersByTime(1);
expect(espion).toHaveBeenCalledTimes(1);
vi.useRealTimers();
});
Deux vérifications impossibles autrement : avant l'échéance, rien ne s'est produit ; après, exactement un appel. Et le test dure une milliseconde.
L'espion
const espion = vi.fn();
espion("a", 1);
expect(espion).toHaveBeenCalledTimes(1);
expect(espion).toHaveBeenCalledWith("a", 1);
Pour les cas où ce qui compte est qu'un appel ait eu lieu — un envoi de courriel, une écriture de journal, une invalidation de cache.
Les termes à connaître
- Doublure
Tout objet qui remplace une dépendance réelle le temps d'un test — réseau, horloge, stockage. Le terme couvre les espions, les bouchons et les simulacres.
- Espion
Une doublure qui enregistre ses appels sans changer le comportement. Pour vérifier qu'une fonction a bien été appelée, et avec quoi.
- Bouchon
Une doublure qui rend une réponse prédéfinie. Pour contrôler ce qu'une dépendance renvoie — y compris une erreur.
- Injection
Passer la dépendance en argument au lieu de l'importer. C'est la technique qui dispense d'outillage de remplacement — et la plus simple.
- Horloge simulée
Un remplacement du temps qui permet d'avancer de mille secondes instantanément. Indispensable pour tester un anti-rebond sans attendre.
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.