Tests unitaires avec Jest

Objectifs

À la fin de cette leçon, vous saurez :

• écrire et lancer des tests Jest ;
• utiliser les matchers essentiels ;
• tester les cas d'erreur attendus.

🔗 Pour vous rafraîchir la mémoire : package.json et scripts npm · modules : import/export

Le premier test

// math.spec.ts
import { calculerFrais } from "./math.js";

describe("calculerFrais", () => {
  it("applique 0.29 pour la carte", () => {
    expect(calculerFrais("carte")).toBe(0.29);
  });

  it("renvoie null pour un moyen inconnu", () => {
    expect(calculerFrais("cheval" as never)).toBeNull();
  });
});

npm test          # ou npx jest

describe groupe, it décrit un comportement en phrase lisible. La sortie :

PASS  src/math.spec.ts
  calculerFrais
    ✓ applique 0.29 pour la carte (2 ms)
    ✓ renvoie null pour un moyen inconnu

Les matchers du quotidien

Piège classique : objets et tableaux exigent toEqual, pas toBe — rappel du chapitre mémoire : deux objets au contenu identique ne sont jamais ===.

Tester l'erreur attendue

it("refuse un titre vide", () => {
  expect(() => new Tache("")).toThrow("Titre requis");
});

La fonction est enveloppée dans une flèche : c'est le LANCEMENT qui doit rejeter. Sans elle, l'exception sort du test et le fait échouer brutalement sans vérifier le message.

Organiser ses tests

Conventions du projet Devmind : fichiers *.spec.ts à côté du code testé (admin.service.spec.ts teste admin.service.ts). Chaque spec suit le même plan que la classe testée : un describe par méthode publique, un it par comportement identifié (nominal + limites + erreurs).

Le réflexe TDD léger : avant de corriger un bug, écrivez le test qui l'aurait attrapé ; il échoue, vous corrigez, il passe — et il protège pour toujours contre la régression.

Exercice

1. Testez moyenne : nominal, liste vide → null, valeurs négatives.
2. Testez votre basculer(t) immuable : l'original ne change pas.
3. Faites échouer volontairement un test et lisez le diff fourni par Jest.
4. Pourquoi tester "l'original ne change pas" est-il précieux ici ?

Résumé

• describe/it + matchers : la grammaire minimale suffisante.
• Erreurs attendues : () => ... + toThrow.
• Un bug corrigé = un test de régression ajouté.