CKTIS / JavaScript
Number.NaN: valore Number «non è un numero»
Number.NaN è il valore speciale di Number per un risultato numerico non valido o indeterminato ed è lo stesso valore del NaN globale.
Versione: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintassi
Number.NaNNumber.NaN è il valore NaN di tipo Number, identico al NaN globale. Può derivare da una conversione numerica fallita o da un’operazione come 0 / 0. Non è un’eccezione e leggere la proprietà non genera errori; molte operazioni numeriche successive con NaN producono anch’esse NaN.
NaN è l’unico valore JavaScript diverso da sé stesso sia con == sia con ===, quindi value === Number.NaN è sempre falso. Usa Number.isNaN(value) senza coercizione oppure Object.is(value, Number.NaN). typeof Number.NaN è "number"; i confronti d’ordine con NaN sono falsi e JSON.stringify scrive NaN in array e proprietà di oggetti come null.
La proprietà esiste da ECMAScript 1 e non è scrivibile, enumerabile né configurabile. L’esempio restituisce Number.NaN come risultato esplicito del parsing fallito di una lettura e confronta test corretti ed errati. Un risultato di errore distinto è spesso più chiaro in un’API pubblica, perché NaN può propagarsi nei calcoli o cambiare significato durante la serializzazione.
Il NaN globale è una proprietà dell’oggetto globale con lo stesso valore Number di Number.NaN; confrontarli per identità con === restituisce comunque false, perché ogni valore NaN è diverso da sé stesso. La proprietà globale non è scrivibile, enumerabile né configurabile, ma l’identificatore NaN può essere oscurato da un binding locale, quindi Number.NaN può essere meno ambiguo. Nella lezione sorgente un’età vuota viene convertita esplicitamente nel NaN globale e poi rifiutata da Number.isInteger().
Esempi
function parseMeasurement(text) {
const value = Number(text);
return Number.isNaN(value) ? Number.NaN : value;
}
const failed = parseMeasurement("bad");
console.log(Number.isNaN(failed), failed === Number.NaN, Object.is(failed, Number.NaN));
console.log(typeof Number.NaN, Number.NaN === NaN);
console.log(JSON.stringify({ value: Number.NaN }));
const descriptor = Object.getOwnPropertyDescriptor(Number, "NaN");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);Risultato
true false true
number false
{"value":null}
false false falseNumber.NaN → risultato di errore esplicito e test corretto di NaN