Formations — 1 037 leçons en français

Accueil › Architecture & design patterns › Ce que l'hexagone rend testable

Ce que l'hexagone rend testable

Ports, adaptateurs et hexagoneintermediaire

Le bénéfice le plus concret de l'hexagone est la vitesse des tests. Le domaine ne dépend de rien, donc son test ne démarre rien.

// test du domaine : aucune base, aucun serveur, aucune horloge réelle
const horloge = { maintenant: () => "2026-01-01T00:00:00Z" };
const commandes = creerDepotMemoire([{ id: "c1", lignes: [] }]);
const cloturer = creerClotureCommande({ commandes, horloge });

assert.deepEqual(cloturer("c1"), { ok: false, motif: "vide" });

Le test s'exécute en millisecondes et donne toujours le même résultat, y compris un 31 décembre à 23 h 59. L'horloge est un port comme un autre : elle est injectée, donc figée.

Les adaptateurs, eux, se testent séparément — et contre la vraie technologie. On ne vérifie pas une règle métier dans un test d'adaptateur ; on vérifie que la traduction est fidèle.

// test d'adaptateur : on vérifie la traduction, pas la décision
const depot = depotSql(connexionDeTest);
depot.enregistrer({ id: "c1", lignes: [{ ref: "A", qte: 2 }] });
assert.deepEqual(depot.parId("c1").lignes.length, 1);

Entre les deux, une suite unique de tests de contrat s'exécute contre toutes les implémentations d'un port — celle de production et celle en mémoire. C'est elle qui empêche le double de test de mentir.

Les termes à connaître

Test de domaine

Un test qui exerce une règle métier sans base, sans HTTP et sans horloge réelle. Il s'exécute en mémoire, de façon déterministe.

Double de test

Une implémentation de port écrite pour le test : tableau en mémoire, horloge figée, compteur d'envois.

Test de contrat

Une batterie de tests écrite une fois pour un port, puis exécutée contre chacune de ses implémentations.

Adaptateur en mémoire

L'implémentation la plus simple d'un port secondaire. Elle n'est utile que si elle passe le même test de contrat que la vraie.

Horloge injectée

Un port secondaire qui rend l'instant courant. Il transforme un test dépendant du calendrier en test reproductible.

Pyramide de tests

La répartition visée : beaucoup de tests de domaine rapides, quelques tests d'adaptateur, très peu de tests de bout en bout.

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.