Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

isNaN() — sprawdzanie NaN po konwersji

Globalna funkcja isNaN(value) najpierw konwertuje argument do typu Number, a następnie sprawdza, czy wynikiem jest NaN. W odróżnieniu od Number.isNaN() może zwrócić true także dla tekstu lub undefined, dlatego nie jest ogólnym testem poprawności liczby.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

isNaN(value)

isNaN(value) to globalna funkcja ECMAScript, a nie API przeglądarki. Stosuje operację ToNumber do argumentu i zwraca true, jeśli wynikiem jest NaN; w przeciwnym razie zwraca false. NaN jest specjalną wartością typu Number, oznaczającą wynik niebędący poprawną liczbą, na przykład rezultat 0 / 0.

Konwersja ma znaczenie: isNaN("hello") i isNaN(undefined) zwracają true, ale isNaN("42"), isNaN("") i isNaN(null) zwracają false. Pusty tekst i null są konwertowane do 0. Wywołanie isNaN() bez argumentu działa jak przekazanie undefined i zwraca true.

Number.isNaN(value) nie wykonuje konwersji: zwraca true wyłącznie dla wartości NaN typu Number. Używaj go, gdy chcesz sprawdzić samą wartość, a nie rezultat jej konwersji. Nie porównuj z NaN za pomocą ===, ponieważ nawet NaN === NaN daje false. Wynik false z isNaN nie dowodzi, że argument jest liczbą ani że jest skończony: isNaN(Infinity) również daje false.

Konwersja może zgłosić wyjątek zamiast zwrócić wartość logiczną. Argument typu Symbol lub BigInt, na przykład isNaN(1n), powoduje TypeError. Konwersja obiektu może uruchomić jego kod konwersji i propagować zgłoszony wyjątek. Nie traktuj więc isNaN jako bezpiecznego walidatora dowolnych danych.

Przykłady

const values = [NaN, "hello", "42", "", null, undefined, Infinity];

for (const value of values) {
  console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}

Wynik

NaN: true / true
hello: true / false
42: false / false
: false / false
null: false / false
undefined: true / false
Infinity: false / false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła