CKTIS / JavaScript
Number.isNaN: dokładny test wartości NaN bez koercji
Number.isNaN zwraca true wyłącznie wtedy, gdy argument ma typ Number i jest specjalną wartością NaN.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
Number.isNaN(number)Number.isNaN(value) sprawdza jednocześnie typ Number i wartość NaN. Zwraca true dla NaN pochodzącego z nieudanej konwersji liczbowej lub nieokreślonego działania, a false dla wszystkich innych wartości Number, w tym Infinity oraz -0. Brak argumentu daje false, ponieważ undefined nie ma typu Number.
Metoda nie stosuje ToNumber: "NaN", "oops", undefined, obiekty, BigInt i Symbol dają false bez konwersji i bez TypeError. Globalne isNaN działa inaczej, ponieważ najpierw konwertuje argument; dlatego isNaN("oops") daje true, lecz Number.isNaN("oops") daje false, a niektóre konwersje globalnej wersji mogą rzucić. Number.isNaN jest zwykle bezpieczniejszym testem wyniku obliczenia.
Metoda istnieje od ECMAScript 2015 i nie jest konstruktorem. Przykład jawnie konwertuje odczyty przez Number, a następnie oznacza tylko wynik NaN jako niepoprawny. Zwróć uwagę, że Number("") daje 0, więc Number.isNaN nie zastępuje sprawdzenia, czy pusty tekst jest dozwolony przez format danych.
Przykłady
function parseReading(text) {
const value = Number(text);
return Number.isNaN(value) ? "invalid" : value.toFixed(1);
}
console.log(["18.5", "oops", ""].map(parseReading).join(" | "));
console.log(Number.isNaN(NaN), Number.isNaN("NaN"), Number.isNaN());
console.log(isNaN("oops"), Number.isNaN("oops"));
console.log(Number.isNaN(1n), Number.isNaN(Symbol("x")));Wynik
18.5 | invalid | 0.0 true false false true false false false
Number.isNaN → walidacja wyniku jawnej konwersji odczytów