Formations — 1 037 leçons en français

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.

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.