CKTIS / JavaScript
Test e asserzioni
Un test confronta il comportamento osservato con quello atteso, mentre un’asserzione segnala una condizione non soddisfatta. Scopri un piccolo test unitario che usa un modulo integrato di Node.js e perché contano le regole di confronto e i casi limite.
Versione: 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.
Sintassi
function assertEqual(actual, expected, label) {
if (!Object.is(actual, expected)) {
throw new Error(label);
}
}Un test verifica il comportamento di un programma con input e risultati attesi definiti. Se un’asserzione fallisce, il test fallisce. In un test unitario, concentrati su una piccola unità, come una funzione: prepara gli input, chiama la funzione e verifica il risultato. La semplice assenza di un’eccezione non dimostra che il risultato sia corretto.
Il frammento di sintassi definisce una funzione personalizzata, assertEqual. Usa Object.is e, in caso di mancata corrispondenza, esegue throw new Error(label). Object.is considera NaN uguale a NaN, distingue +0 da -0 e confronta gli oggetti in base all’identità, non al contenuto. Non è un confronto profondo.
L’esempio eseguibile non usa assertEqual. Importa il modulo node:assert/strict, integrato in Node.js, e chiama assert.equal, che in questa modalità applica le regole di confronto di Object.is. Le tre asserzioni verificano la somma di due numeri positivi, la somma di due numeri opposti e la stringa "0.3" ottenuta formattando la somma 0.1 + 0.2 con toFixed(1). L’ultima asserzione confronta una stringa, non il risultato numerico non formattato. Un errore di asserzione non intercettato interrompe lo script prima che stampi il messaggio di riuscita.
Scegli sia input ordinari sia casi limite in base al contratto della funzione. Definisci i risultati attesi indipendentemente dall’implementazione sottoposta a test. Per controllare il test stesso, modifica deliberatamente un risultato atteso e verifica che l’asserzione fallisca. Superare questi casi non dimostra la correttezza per tutti gli input.
Il frammento di sintassi usa funzionalità disponibili da ECMAScript 2015 o da un’edizione precedente e descritte nella specifica ECMAScript. L’API di asserzione è descritta nella documentazione di Node.js. L’esempio richiede Node.js, ma non richiede né API del browser né librerie di terze parti. La presenza di Node 24 in un repository non dimostra il supporto delle API del browser.
Esempi
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");
Risultato
3 assertions passed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.