WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

NaN: der besondere Zahlenwert und wie man ihn erkennt

`NaN` ist ein besonderer Wert vom Typ `Number`. Mit `Number.isNaN()` prüfst du darauf, ohne das Argument umzuwandeln. Die globale Funktion `isNaN()` wandelt es dagegen zuerst um.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

NaN
Number.NaN
Number.isNaN(value)
isNaN(value)

NaN (kurz für „Not-a-Number“) ist ein besonderer primitiver Wert vom Typ Number. Ausdrücke wie 0 / 0 und Number("oops") liefern ihn, statt eine Ausnahme auszulösen. typeof NaN ergibt "number". Die globale Eigenschaft NaN und die statische Eigenschaft Number.NaN liefern denselben Wert, der nicht mit der Zeichenkette "NaN" zu verwechseln ist.

Prüfe einen Wert mit Number.isNaN(value). Die Methode gibt nur für NaN den Wert true zurück und wandelt das Argument nicht um. Weder == noch === behandeln NaN als gleich zu sich selbst: NaN === NaN ergibt false. Dagegen liefert Object.is(NaN, Number.NaN) den Wert true, weil die Methode eine andere Vergleichsregel verwendet.

Die globale Funktion isNaN(value) versucht zuerst, das Argument in einen Number-Wert umzuwandeln. Deshalb liefert isNaN("oops") den Wert true, während isNaN("") den Wert false liefert, weil die leere Zeichenkette zu 0 wird. Bei Werten vom Typ BigInt oder Symbol löst diese Umwandlung einen TypeError aus; Number.isNaN() liefert für solche Werte false.

Wenn du einen endlichen Number-Wert brauchst, verwende Number.isFinite(value). Die Prüfung !Number.isNaN(value) reicht nicht aus: Sie lässt auch unendliche Werte und Werte anderer Typen durch.

Beispiele

{
  const input = "oops";
  const value = Number(input);
  console.log(value);
  console.log(Number.isNaN(input));
  console.log(isNaN(input));
  console.log(Number.isNaN(value));
  console.log(value === NaN);
  console.log(Object.is(value, Number.NaN));
}

Ergebnis

NaN
false
true
true
false
true

`input` bleibt eine Zeichenkette; erst `Number(input)` ergibt `NaN`. Die letzten beiden Ausgabezeilen zeigen den Unterschied zwischen `===` und `Object.is()`.

Zugehörige Lektionen

  • JavaScript · Lektion 12 · Mittlere Stufe · Version: 3

Quellen