Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.NaN

Number.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 false

Number.NaN → jawny wynik błędu i poprawne testowanie NaN

Źródła