Formations — 1 037 leçons en français

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

toBe compare par identité — pour des primitifs. toEqual compare 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.

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.