WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Testen und Assertions

Ein Test vergleicht beobachtetes Verhalten mit einer Erwartung; eine Assertion meldet, wenn eine Bedingung nicht erfüllt ist. Sieh dir einen kleinen Unit-Test mit einem integrierten Node.js-Modul an und erfahre, warum Vergleichsregeln und Grenzfälle wichtig sind.

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.

Syntax

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

Ein Test prüft das Verhalten eines Programms anhand festgelegter Eingaben und Erwartungen. Schlägt eine Assertion fehl, ist der Test fehlgeschlagen. Konzentriere dich bei einem Unit-Test auf eine kleine Einheit, etwa eine Funktion: Bereite die Eingaben vor, rufe die Funktion auf und prüfe das Ergebnis. Dass keine Ausnahme auftritt, beweist allein noch nicht, dass das Ergebnis korrekt ist.

Der Syntaxausschnitt definiert die eigene Funktion assertEqual. Sie verwendet Object.is und führt bei einer Abweichung throw new Error(label) aus. Object.is behandelt NaN als gleich NaN, unterscheidet +0 von -0 und vergleicht Objekte anhand ihrer Identität, nicht ihres Inhalts. Es handelt sich nicht um einen tiefen Vergleich.

Das ausführbare Beispiel verwendet assertEqual nicht. Es importiert das integrierte Node.js-Modul node:assert/strict und ruft assert.equal auf. In diesem Modus gelten dafür die Vergleichsregeln von Object.is. Die drei Assertions prüfen die Summe zweier positiver Zahlen, die Summe zweier Zahlen mit gleichem Betrag und entgegengesetztem Vorzeichen sowie die Zeichenkette "0.3", die entsteht, wenn die Summe 0.1 + 0.2 mit toFixed(1) formatiert wird. Die letzte Assertion prüft eine Zeichenkette, nicht das unformatierte numerische Ergebnis. Ein nicht abgefangener Assertion-Fehler beendet das Skript, bevor es die Erfolgsmeldung ausgibt.

Wähle sowohl gewöhnliche Eingaben als auch Grenzfälle aus dem Vertrag der Funktion. Leite die Erwartungen unabhängig von der getesteten Implementierung her. Um den Test selbst zu prüfen, ändere absichtlich eine Erwartung und vergewissere dich, dass die Assertion fehlschlägt. Das Bestehen dieser Fälle beweist nicht die Korrektheit für alle Eingaben.

Der Syntaxausschnitt verwendet Sprachmerkmale, die seit ECMAScript 2015 oder früher verfügbar und in der ECMAScript-Spezifikation beschrieben sind. Die Assertion-API ist in der Node.js-Dokumentation beschrieben. Das Beispiel benötigt Node.js, aber keine Browser-APIs und keine Drittanbieterbibliothek. Dass in einem Repository Node 24 vorhanden ist, belegt keine Unterstützung von Browser-APIs.

Beispiele

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");

Ergebnis

3 assertions passed

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen