Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Number.isNaN: test esatto di NaN senza coercizione

Number.isNaN restituisce true solo quando l’argomento è di tipo Number e ha il valore speciale NaN.

Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintassi

Number.isNaN(number)

Number.isNaN(value) controlla sia il tipo Number sia il valore NaN. Restituisce true per un NaN prodotto da una conversione numerica fallita o da un’operazione aritmetica indefinita, e false per ogni altro Number, inclusi Infinity e -0. Un argomento mancante dà false perché undefined non è un Number.

Il metodo non applica ToNumber: "NaN", "oops", undefined, oggetti, BigInt e Symbol producono false senza conversione né TypeError. isNaN globale differisce perché converte prima; quindi isNaN("oops") è true, mentre Number.isNaN("oops") è false, e alcune conversioni della forma globale possono generare eccezioni. Number.isNaN è in genere il test più sicuro per il risultato di un calcolo.

Il metodo esiste da ECMAScript 2015 e non è un costruttore. L’esempio converte esplicitamente le letture con Number e poi contrassegna come non valido solo un risultato NaN. Nota che Number("") è 0, quindi Number.isNaN non sostituisce il controllo che il formato consenta testo vuoto.

Esempi

function parseReading(text) {
  const value = Number(text);
  return Number.isNaN(value) ? "invalid" : value.toFixed(1);
}

console.log(["18.5", "oops", ""].map(parseReading).join(" | "));
console.log(Number.isNaN(NaN), Number.isNaN("NaN"), Number.isNaN());
console.log(isNaN("oops"), Number.isNaN("oops"));
console.log(Number.isNaN(1n), Number.isNaN(Symbol("x")));

Risultato

18.5 | invalid | 0.0
true false false
true false
false false

Number.isNaN → convalida del risultato della conversione esplicita delle letture

Fonti