Types de tests et structure AAA

Objectifs

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

• classer les quatre niveaux de tests ;
• écrire un test Arrange-Act-Assert ;
• savoir quoi tester en premier.

🔗 Pour vous rafraîchir la mémoire : méthodes HTTP et codes de statut

La pyramide, du bas au sommet

        /  E2E  \        ← parcours complets (lents, fragiles, peu nombreux)
       / API     \       ← endpoints via HTTP (moyens)
      / Intégration\     ← avec vraie base (moyens)
     / Unitaires    \    ← fonctions/classes isolées (rapides, nombreux)

Niveau	Vérifie	Vitesse	Exemple
Unitaire	une unité isolée	ms	calculerFrais('carte') === 0.29
Intégration	code + base réelle	s	repository crée/lit vraiment
API	requête HTTP complète	10ms-s	POST /tasks → 201 + JSON
E2E	le système vu par l'humain	s-min	Playwright clique tout

Plus on monte : plus de confiance, plus de coût. D'où la pyramide : beaucoup d'unitaires rapides, quelques E2E sur les parcours critiques.

AAA : la structure de tout test

it("calcule les frais carte", () => {
  // Arrange — préparer
  const moyen = "carte";
  // Act — agir (UNE action)
  const frais = calculerFrais(moyen);
  // Assert — vérifier UNE attente
  expect(frais).toBe(0.29);
});

Un test = un comportement, trois blocs, aucune logique conditionnelle. Si vous écrivez des if dans un test, c'est plusieurs tests.

Les cas à couvrir systématiquement

Pour chaque fonction :

1. cas nominal         → l'entrée normale
2. cas limite          → vide, zéro, maximum
3. erreur attendue     → entrée invalide rejette correctement

describe("moyenne", () => {
  it("calcule la moyenne simple", ...);           // nominal
  it("renvoie null pour une liste vide", ...);    // limite
  it("ignore les valeurs non numériques", ...);   // erreur attendue
});

Ces trois lignes de description forment déjà la spécification exécutable de votre fonction — c'est aussi de la documentation qui ne ment jamais.

Quoi tester en premier

Priorité pragmatique quand tout est à faire :

1. Les règles métier pures (calculs, validations) — unitaires, ROI immédiat.
2. Les endpoints critiques (authentification, paiements) — niveau API.
3. Le parcours d'inscription complet — un seul E2E bien choisi.

Exercice

1. Classez : "le slug se génère sans accents", "POST /users renvoie 409 si doublon", "un utilisateur achète et reçoit son reçu".
2. Écrivez les trois cas de estPalindrome en AAA.
3. Pourquoi un E2E ne remplace-t-il pas mille unitaires ?

Résumé

• Pyramide : beaucoup d'unitaires, quelques E2E.
• AAA sans logique ; trois familles de cas par fonction.
• Commencer par le métier pur : meilleur retour sur effort.