Number.isNaN()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Number.isNaN() bestimmt, ob der übergebene Wert der Zahlenwert NaN ist, und gibt false zurück, wenn die Eingabe nicht vom Typ Number ist. Es ist eine robustere Version der ursprünglichen globalen Funktion isNaN().

Probieren Sie es aus

Syntax

js
Number.isNaN(value)

Parameter

value

Der Wert, der auf NaN getestet werden soll.

Rückgabewert

Der boolesche Wert true, wenn der angegebene Wert eine Zahl mit dem Wert NaN ist. Andernfalls false.

Beschreibung

Die Funktion Number.isNaN() bietet eine bequeme Möglichkeit, auf Gleichheit mit NaN zu prüfen. Beachten Sie, dass Sie die Gleichheit mit NaN nicht mit den Operatoren == oder === testen können, da diese, im Gegensatz zu allen anderen Wertvergleichen in JavaScript, immer false ergeben, wenn einer der Operanden NaN ist, selbst wenn der andere Operand ebenfalls NaN ist.

Da x !== x nur für NaN unter allen möglichen JavaScript-Werten wahr ist, kann Number.isNaN(x) auch durch einen Test für x !== x ersetzt werden, obwohl letzterer weniger lesbar ist.

Im Gegensatz zur globalen Funktion isNaN() erzwingt die Methode Number.isNaN() keine Umwandlung des Parameters in eine Zahl. Dies macht es sicher, Werte zu übergeben, die normalerweise in NaN umgewandelt würden, aber tatsächlich nicht denselben Wert wie NaN darstellen. Dies bedeutet auch, dass nur Werte des Typs Number, die ebenfalls NaN sind, true zurückgeben.

Beispiele

Verwendung von isNaN()

js
Number.isNaN(NaN); // true
Number.isNaN(Number.NaN); // true
Number.isNaN(0 / 0); // true
Number.isNaN(37); // false

Unterschied zwischen Number.isNaN() und globalem isNaN()

Number.isNaN() versucht nicht, den Parameter in eine Zahl umzuwandeln, sodass Nicht-Zahlen immer false zurückgeben. Die folgenden sind alle false:

js
Number.isNaN("NaN");
Number.isNaN(undefined);
Number.isNaN({});
Number.isNaN("blabla");
Number.isNaN(true);
Number.isNaN(null);
Number.isNaN("37");
Number.isNaN("37.37");
Number.isNaN("");
Number.isNaN(" ");

Die globale Funktion isNaN() konvertiert ihren Parameter zu einer Zahl:

js
isNaN("NaN"); // true
isNaN(undefined); // true
isNaN({}); // true
isNaN("blabla"); // true
isNaN(true); // false, this is coerced to 1
isNaN(null); // false, this is coerced to 0
isNaN("37"); // false, this is coerced to 37
isNaN("37.37"); // false, this is coerced to 37.37
isNaN(""); // false, this is coerced to 0
isNaN(" "); // false, this is coerced to 0

Spezifikationen

Specification
ECMAScript Language Specification
# sec-number.isnan

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch