Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Tests et assertions

Un test compare le comportement observé à une attente, tandis qu’une assertion signale qu’une condition n’est pas remplie. Découvrez un petit test unitaire qui utilise un module intégré à Node.js et voyez pourquoi les règles de comparaison et les cas limites sont importants.

Version : Syntax snippet: Requires ECMAScript 2015 or later because it uses Object.is, which was standardized in ECMAScript 2015. Executable example: verified in Node.js 24.22.2 using the built-in node:assert/strict module. This does not establish browser API support.

Syntaxe

function assertEqual(actual, expected, label) {
  if (!Object.is(actual, expected)) {
    throw new Error(label);
  }
}

Un test vérifie le comportement d’un programme pour des entrées et des attentes définies. Si une assertion échoue, le test échoue. Dans un test unitaire, concentrez-vous sur une petite unité, comme une fonction : préparez les entrées, appelez la fonction et vérifiez le résultat. L’absence d’exception ne suffit pas à établir que le résultat est correct.

L’extrait de syntaxe définit une fonction personnalisée, assertEqual. Elle utilise Object.is et exécute throw new Error(label) en cas de différence. Object.is considère que NaN est égal à NaN, distingue +0 de -0 et compare les objets selon leur identité plutôt que leur contenu. Il ne s’agit pas d’une comparaison profonde.

L’exemple exécutable n’utilise pas assertEqual. Il importe le module node:assert/strict, intégré à Node.js, et appelle assert.equal, qui applique dans ce mode les règles de comparaison de Object.is. Les trois assertions vérifient la somme de deux nombres positifs, la somme de deux nombres opposés et la chaîne "0.3" obtenue en formatant la somme 0.1 + 0.2 avec toFixed(1). La dernière assertion compare une chaîne, et non le résultat numérique brut. Une erreur d’assertion non interceptée arrête le script avant l’affichage du message de réussite.

Choisissez à la fois des entrées ordinaires et des cas limites définis par le contrat de la fonction. Définissez les attentes indépendamment de l’implémentation testée. Pour vérifier le test lui-même, modifiez volontairement une attente et vérifiez que l’assertion échoue. La réussite de ces cas ne prouve pas que le programme est correct pour toutes les entrées.

L’extrait de syntaxe utilise des fonctionnalités disponibles depuis ECMAScript 2015 ou une édition antérieure et décrites dans la spécification ECMAScript. L’API d’assertion est décrite dans la documentation de Node.js. L’exemple nécessite Node.js, mais ni API de navigateur ni bibliothèque tierce. La présence de Node 24 dans un dépôt ne démontre pas la prise en charge des API de navigateur.

Exemples

import assert from "node:assert/strict";

const add = (left, right) => left + right;
assert.equal(add(2, 3), 5);
assert.equal(add(-1, 1), 0);
assert.equal(add(0.1, 0.2).toFixed(1), "0.3");
console.log("3 assertions passed");

Résultat

3 assertions passed

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources