CKTIS / JavaScript
Number.NaN: wartość Number „nie-liczba”
Number.NaN jest specjalną wartością typu Number oznaczającą nieprawidłowy lub nieokreślony wynik liczbowy i jest tą samą wartością co globalne NaN.
Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2
Składnia
Number.NaNNumber.NaN jest wartością NaN w typie Number, taką samą jak globalne NaN. Może powstać na przykład po nieudanej konwersji liczbowej lub działaniu takim jak 0 / 0. Nie jest wyjątkiem i samo odczytanie właściwości niczego nie rzuca; wiele dalszych działań liczbowych z NaN także daje NaN.
NaN jest jedyną wartością JavaScript, która nie jest równa samej sobie przez == ani ===, dlatego value === Number.NaN zawsze jest fałszem. Do testu użyj Number.isNaN(value) bez koercji albo Object.is(value, Number.NaN). typeof Number.NaN daje "number"; porównania porządkowe z NaN są fałszywe, a JSON.stringify zapisuje NaN w tablicach i właściwościach jako null.
Właściwość istnieje od ECMAScript 1 i jest niewritable, nieenumerowalna oraz niekonfigurowalna. Przykład zwraca Number.NaN jako jawny wynik nieudanego parsowania odczytu i pokazuje poprawne oraz błędne testy. W API publicznym często czytelniejszy jest osobny wynik błędu, ponieważ NaN może łatwo rozprzestrzeniać się w obliczeniach lub zmienić znaczenie przy serializacji.
Globalne NaN jest właściwością obiektu globalnego o tej samej wartości Number co Number.NaN; samo tożsamościowe porównanie obu przez === nadal daje false, ponieważ każda wartość NaN jest nierówna samej sobie. Globalna właściwość jest niewritable, nieenumerowalna i niekonfigurowalna, lecz identyfikator NaN może zostać przesłonięty lokalnym wiązaniem, dlatego Number.NaN bywa jednoznaczniejsze. W lekcji pusta wartość wieku jest jawnie zamieniana na globalne NaN, a następnie odrzucana przez Number.isInteger().
Przykłady
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);Wynik
true false true
number false
{"value":null}
false false falseNumber.NaN → jawny wynik błędu i poprawne testowanie NaN