Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.NaN

Number.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 false

Number.NaN → risultato di errore esplicito e test corretto di NaN

Fonti