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