Pourquoi tester ? Premiers tests avec node:assert

Vous corrigez un calcul de TVA, tout semble fonctionner… et trois semaines plus tard, quelqu’un découvre que les remises ne s’appliquent plus. Un test automatisé est un petit programme qui exécute votre code et vérifie qu’il produit le résultat attendu. Lancé à chaque modification, il détecte ces régressions en quelques secondes.

Les tests apportent aussi :

• de la confiance pour refactoriser : on peut réorganiser le code sans peur ;
• une documentation vivante : les tests montrent comment utiliser une fonction ;
• un meilleur design : un code difficile à tester est souvent trop couplé.

La pyramide des tests

Niveau	Ce qu’on teste	Vitesse	Quantité
Unitaire	Une fonction ou un module isolé	Millisecondes	Beaucoup
Intégration	Plusieurs modules ensemble (route + base)	Secondes	Moyenne
Bout en bout (E2E)	L’application entière via le navigateur	Lent	Peu

On commence par la base : les tests unitaires.

Les assertions avec node:assert

Node.js fournit le module node:assert. Une assertion vérifie une condition et lève une AssertionError si elle est fausse.

const assert = require("node:assert");

function prixTTC(ht, taux = 0.2) {
  if (ht < 0) throw new RangeError("Prix négatif");
  return Math.round(ht * (1 + taux) * 100) / 100;
}

// Valeurs simples : comparaison stricte (===)
assert.strictEqual(prixTTC(10), 12);
assert.strictEqual(prixTTC(10, 0.055), 10.55);

// Objets et tableaux : comparaison du contenu
assert.deepStrictEqual([1, 2].map((x) => x * 2), [2, 4]);

// Erreurs : on passe une FONCTION qui sera appelée par assert
assert.throws(() => prixTTC(-1), RangeError);

// Expressions régulières
assert.match("Commande #123", /#\d+/);

Attention à deux pièges :

• assert.equal (non strict) utilise == : assert.equal(1, "1") passe. Préférez les variantes strictes, ou importez require("node:assert/strict").
• assert.strictEqual({a: 1}, {a: 1}) échoue : deux objets distincts ne sont pas ===. Utilisez deepStrictEqual.

Choisir ses cas de test

Pour chaque fonction, posez-vous ces questions :

1. Cas nominal : l’usage normal donne-t-il le bon résultat ?
2. Cas limites : zéro, chaîne vide, tableau vide, un seul élément, valeurs maximales, arrondis.
3. Entrées invalides : type incorrect, valeur négative, undefined.

Un message d’erreur clair aide énormément quand un test échoue :

assert.strictEqual(prixTTC(0), 0, "Un prix nul doit rester nul");

À retenir

Un test = préparer des données, appeler le code, vérifier le résultat. Utilisez les assertions strictes, testez les cas limites, et gardez des tests rapides et indépendants.