CKTIS / JavaScript
isNaN() – NaN nach der Konvertierung prüfen
Die globale Funktion isNaN(value) konvertiert ihr Argument zuerst in Number und prüft dann, ob das Ergebnis NaN ist. Anders als Number.isNaN() kann sie auch für Zeichenketten oder undefined true zurückgeben und ist daher kein allgemeiner Test auf eine gültige Zahl.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
isNaN(value)isNaN(value) ist eine globale ECMAScript-Funktion und keine Browser-API. Sie wendet die Operation ToNumber auf ihr Argument an und gibt true zurück, wenn das Ergebnis NaN ist; andernfalls gibt sie false zurück. NaN ist ein spezieller Wert des Typs Number, der ein Ergebnis bezeichnet, das keine gültige Zahl ist, zum Beispiel das Ergebnis von 0 / 0.
Die Konvertierung ist wichtig: isNaN("hello") und isNaN(undefined) geben true zurück, aber isNaN("42"), isNaN("") und isNaN(null) geben false zurück. Der leere String und null werden zu 0 konvertiert. Ein Aufruf von isNaN() ohne Argument verhält sich wie die Übergabe von undefined und gibt true zurück.
Number.isNaN(value) führt keine Konvertierung durch: Es gibt nur für den Number-Wert NaN den Wert true zurück. Verwende es, wenn du den Wert selbst und nicht das Ergebnis seiner Konvertierung prüfen möchtest. Vergleiche nicht mit NaN mithilfe von ===, denn selbst NaN === NaN ergibt false. Ein Ergebnis false von isNaN beweist weder, dass das Argument eine Zahl ist, noch, dass es endlich ist: Auch isNaN(Infinity) ergibt false.
Die Konvertierung kann eine Ausnahme auslösen, statt einen booleschen Wert zurückzugeben. Ein Argument vom Typ Symbol oder BigInt, zum Beispiel isNaN(1n), verursacht einen TypeError. Bei der Konvertierung eines Objekts kann dessen Konvertierungscode ausgeführt werden und eine ausgelöste Ausnahme weitergegeben werden. Behandle isNaN daher nicht als sicheren Validator für beliebige Daten.
Beispiele
const values = [NaN, "hello", "42", "", null, undefined, Infinity];
for (const value of values) {
console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}Ergebnis
NaN: true / true hello: true / false 42: false / false : false / false null: false / false undefined: true / false Infinity: false / false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.