CKTIS / JavaScript
NaN: il valore speciale di tipo Number e come riconoscerlo
`NaN` è un valore speciale del tipo `Number`. Per riconoscerlo senza convertire l’argomento, usa `Number.isNaN()` anziché la funzione globale `isNaN()`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
NaN
Number.NaN
Number.isNaN(value)
isNaN(value)NaN (abbreviazione di «Not-a-Number») è un valore primitivo speciale del tipo Number. Per esempio, 0 / 0 e Number("oops") producono questo valore invece di sollevare un’eccezione. typeof NaN restituisce "number". La proprietà globale NaN e la proprietà statica Number.NaN espongono lo stesso valore, distinto dalla stringa "NaN".
Usa Number.isNaN(value) per verificare un valore. Il metodo restituisce true soltanto per NaN e non converte l’argomento. Né == né === considerano NaN uguale a sé stesso: NaN === NaN vale false. Invece Object.is(NaN, Number.NaN) restituisce true perché applica una regola di confronto diversa.
La funzione globale isNaN(value) tenta prima di convertire l’argomento in un valore di tipo Number. Per questo isNaN("oops") restituisce true, mentre isNaN("") restituisce false perché la stringa vuota viene convertita in 0. Per i valori di tipo BigInt o Symbol, la conversione solleva un TypeError; Number.isNaN() restituisce false per questi valori.
Se ti serve un valore finito di tipo Number, usa Number.isFinite(value). Verificare soltanto !Number.isNaN(value) non basta: il controllo accetta anche valori infiniti e valori di altri tipi.
Esempi
{
const input = "oops";
const value = Number(input);
console.log(value);
console.log(Number.isNaN(input));
console.log(isNaN(input));
console.log(Number.isNaN(value));
console.log(value === NaN);
console.log(Object.is(value, Number.NaN));
}Risultato
NaN false true true false true
`input` rimane una stringa; è `Number(input)` a produrre `NaN`. Le ultime due righe dell’output mostrano la differenza tra `===` e `Object.is()`.
Lezioni correlate
- JavaScript · Lezione 12 · Intermedio · Versione: 3
Fonti
- ECMAScript 2024 — NaN
- ECMAScript 2024 — The Number Type
- ECMAScript 2024 — Number.NaN
- ECMAScript 2024 — Number.isNaN ( number )
- ECMAScript 2024 — isNaN ( number )
- ECMAScript 2024 — ToNumber ( argument )
- ECMAScript 2024 — Object.is ( value1, value2 )
- ECMAScript 2024 — Number.isFinite ( number )
- NaN - JavaScript | MDN