CKTIS / JavaScript
Testowanie i asercje
Test porównuje obserwowane zachowanie z oczekiwaniem, a asercja sygnalizuje niespełnienie warunku. Zobacz prosty test jednostkowy z wbudowanym modułem Node.js i dowiedz się, dlaczego reguły porównywania i przypadki brzegowe mają znaczenie.
Wersja: 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.
Składnia
function assertEqual(actual, expected, label) {
if (!Object.is(actual, expected)) {
throw new Error(label);
}
}Test sprawdza zachowanie programu dla określonych danych wejściowych i oczekiwań. Niepowodzenie asercji oznacza niepowodzenie testu. W teście jednostkowym skup się na małej jednostce, np. funkcji: przygotuj dane, wywołaj funkcję i sprawdź wynik. Sam brak wyjątku nie dowodzi poprawności wyniku.
Fragment składni definiuje własną funkcję assertEqual. Używa ona Object.is, a przy niezgodności wykonuje throw new Error(label). Object.is uznaje NaN za równe NaN, rozróżnia +0 i -0 oraz porównuje obiekty według tożsamości, a nie zawartości. Nie jest to porównanie głębokie.
Uruchamialny przykład nie używa assertEqual. Importuje wbudowany moduł Node.js node:assert/strict i wywołuje assert.equal, które w tym trybie stosuje porównanie według reguł Object.is. Trzy asercje sprawdzają sumę dwóch liczb dodatnich, sumę liczb przeciwnych oraz tekst "0.3" otrzymany po sformatowaniu sumy 0.1 + 0.2 za pomocą toFixed(1). Ostatnia asercja porównuje tekst, a nie surowy wynik liczbowy. Nieprzechwycony wyjątek z asercji przerywa skrypt przed wypisaniem komunikatu o sukcesie.
Dobieraj zarówno typowe dane, jak i przypadki brzegowe wynikające z kontraktu funkcji. Oczekiwania ustal niezależnie od testowanej implementacji. Aby sprawdzić sam test, celowo zmień jedno oczekiwanie i upewnij się, że asercja zgłasza błąd. Przejście tych przypadków nie dowodzi poprawności dla wszystkich danych.
Fragment składni używa mechanizmów języka dostępnych od ECMAScript 2015 lub wcześniej, opisanych w specyfikacji ECMAScript. API asercji opisuje dokumentacja Node.js. Przykład wymaga Node.js, ale nie wymaga API przeglądarkowych ani zewnętrznej biblioteki. Obecność Node 24 w repozytorium nie potwierdza obsługi API przeglądarkowych.
Przykłady
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");
Wynik
3 assertions passed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.