Accueil › JavaScript › Écrire un test
Écrire un test
Tester son JavaScriptavance
npm install -D vitest
{ "scripts": { "test": "vitest", "test:ci": "vitest run" } }
vitest surveille les fichiers et relance ; vitest run passe une fois et
rend un code de sortie — c'est celui de l'intégration continue.
Un test
import { describe, test, expect } from "vitest";
import { ttc } from "./prix.js";
describe("ttc", () => {
test("applique la TVA à 20 %", () => {
expect(ttc(100)).toBe(120);
});
test("refuse une valeur non numérique", () => {
expect(() => ttc("abc")).toThrow();
});
});
Pour vérifier qu'une fonction lève, il faut lui passer une fonction :
expect(() => f()).toThrow(). Écrire expect(f()).toThrow() ferait échouer
le test sur l'exception elle-même.
Préparer, agir, vérifier
test("totalise un panier", () => {
// préparer
const panier = [{ prix: 10, quantite: 2 }, { prix: 5, quantite: 1 }];
// agir
const total = calculerTotal(panier);
// vérifier
expect(total).toBe(25);
});
Les trois temps séparés par une ligne vide. Un test qui mélange les trois se relit deux fois.
toBe ou toEqual
expect(2 + 2).toBe(4); // primitif : identité
expect({ a: 1 }).toEqual({ a: 1 }); // objet : contenu
expect([1, 2]).toEqual([1, 2]); // tableau : contenu
expect({ a: 1 }).toBe({ a: 1 }); // ❌ échoue
toBe compare comme ===. Deux objets distincts de même contenu ne sont
jamais identiques — le mécanisme vu au chapitre sur l'immutabilité.
Un test sans assertion ne vérifie rien
test("le total est correct", () => {
calculerTotal([10, 20]); // ❌ passe quoi qu'il arrive
});
Et il couvre parfaitement ses lignes. C'est le vert le plus trompeur qui existe.
Les termes à connaître
- Vitest
L'outil de test des projets Vite. Il réutilise la configuration du projet — alias, variables, transformation — donc il n'y en a pas à écrire.
- Assertion
La vérification proprement dite. Un test sans assertion passe toujours, et ne vérifie rien.
- Préparer, agir, vérifier
Les trois temps d'un test. Les séparer visuellement rend lisible ce qui est donné, ce qui est fait, et ce qui est attendu.
- toBe et toEqual
toBecompare par identité — pour des primitifs.toEqualcompare les contenus — pour des objets et des tableaux.- Test paramétré
Un même test rejoué sur une table de cas. Une ligne par cas au lieu d'un bloc, et un échec qui nomme la ligne fautive.
- Test isolé
Un test qui ne dépend ni de l'ordre d'exécution ni d'un autre test. Sans isolation, un échec peut venir d'un test précédent.
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.