WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.isNaN: exakter NaN-Test ohne Koercion

Number.isNaN liefert nur dann true, wenn das Argument vom Typ Number und der besondere Wert NaN ist.

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

Syntax

Number.isNaN(number)

Number.isNaN(value) prüft zugleich den Typ Number und den Wert NaN. Für NaN aus einer fehlgeschlagenen Zahlenkonvertierung oder einer undefinierten Rechenoperation liefert es true, für jede andere Number einschließlich Infinity und -0 dagegen false. Ein fehlendes Argument ergibt false, weil undefined keine Number ist.

Die Methode wendet ToNumber nicht an: "NaN", "oops", undefined, Objekte, BigInt und Symbol ergeben ohne Konvertierung oder TypeError den Wert false. Das globale isNaN konvertiert zuerst; deshalb ist isNaN("oops") true, Number.isNaN("oops") aber false, und manche Konvertierungen der globalen Form können werfen. Number.isNaN ist meist der sicherere Test für ein Rechenergebnis.

Die Methode existiert seit ECMAScript 2015 und ist kein Konstruktor. Das Beispiel konvertiert Messwerte ausdrücklich mit Number und markiert danach nur ein NaN-Ergebnis als ungültig. Beachte, dass Number("") 0 ergibt; Number.isNaN ersetzt daher nicht die Prüfung, ob leerer Text laut Eingabeformat erlaubt ist.

Beispiele

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")));

Ergebnis

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

Number.isNaN → Ergebnis einer ausdrücklichen Messwertkonvertierung prüfen

Quellen