CKTIS / JavaScript
Number.NaN: der Number-Wert „keine Zahl“
Number.NaN ist der besondere Number-Wert für ein ungültiges oder unbestimmtes numerisches Ergebnis und derselbe Wert wie globales NaN.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Number.NaNNumber.NaN ist der NaN-Wert vom Typ Number und identisch mit globalem NaN. Er kann durch eine fehlgeschlagene Zahlenkonvertierung oder eine Operation wie 0 / 0 entstehen. Er ist keine Ausnahme, und das Lesen der Eigenschaft wirft nicht; viele weitere numerische Operationen mit NaN ergeben ebenfalls NaN.
NaN ist der einzige JavaScript-Wert, der unter == und === nicht sich selbst gleicht; daher ist value === Number.NaN immer falsch. Prüfe ohne Koercion mit Number.isNaN(value) oder Object.is(value, Number.NaN). typeof Number.NaN ist "number"; Ordnungsvergleiche mit NaN sind falsch, und JSON.stringify schreibt NaN in Arrays und Objekteigenschaften als null.
Die Eigenschaft existiert seit ECMAScript 1 und ist nicht schreibbar, nicht aufzählbar und nicht konfigurierbar. Das Beispiel liefert Number.NaN als ausdrückliches Ergebnis einer fehlgeschlagenen Messwertanalyse und stellt richtige und falsche Tests gegenüber. In öffentlichen APIs ist ein eigener Fehlerwert oft klarer, da NaN sich still in Berechnungen ausbreiten oder bei Serialisierung seine Bedeutung ändern kann.
Globales NaN ist eine Eigenschaft des globalen Objekts mit demselben Number-Wert wie Number.NaN; ein Identitätsvergleich beider Werte mit === ist dennoch false, weil jeder NaN-Wert sich selbst ungleich ist. Die globale Eigenschaft ist nicht schreibbar, nicht aufzählbar und nicht konfigurierbar, doch der Bezeichner NaN kann durch eine lokale Bindung überschattet werden, weshalb Number.NaN eindeutiger sein kann. In der Quelllektion wird ein leeres Alter ausdrücklich in globales NaN umgewandelt und anschließend von Number.isInteger() abgelehnt.
Beispiele
function parseMeasurement(text) {
const value = Number(text);
return Number.isNaN(value) ? Number.NaN : value;
}
const failed = parseMeasurement("bad");
console.log(Number.isNaN(failed), failed === Number.NaN, Object.is(failed, Number.NaN));
console.log(typeof Number.NaN, Number.NaN === NaN);
console.log(JSON.stringify({ value: Number.NaN }));
const descriptor = Object.getOwnPropertyDescriptor(Number, "NaN");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);Ergebnis
true false true
number false
{"value":null}
false false falseNumber.NaN → ausdrückliches Fehlerergebnis und korrekter NaN-Test