CKTIS / JavaScript
isNaN() — kontrola NaN po převodu
Globální funkce isNaN(value) nejprve převede argument na Number a potom ověří, zda je výsledkem NaN. Na rozdíl od Number.isNaN() může vrátit true také pro řetězce nebo undefined, takže nejde o obecný test platného čísla.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
isNaN(value)isNaN(value) je globální funkce ECMAScriptu, nikoli rozhraní prohlížeče. Na argument použije operaci ToNumber a vrátí true, pokud je výsledkem NaN; jinak vrátí false. NaN je speciální hodnota typu Number, která představuje výsledek, jenž není platným číslem, například výsledek 0 / 0.
Na převodu záleží: isNaN("hello") a isNaN(undefined) vrátí true, ale isNaN("42"), isNaN("") a isNaN(null) vrátí false. Prázdný řetězec a null se převedou na 0. Volání isNaN() bez argumentu se chová stejně jako předání hodnoty undefined a vrátí true.
Number.isNaN(value) žádný převod neprovádí: vrátí true pouze pro hodnotu Number NaN. Použijte ji, chcete-li ověřit samotnou hodnotu, nikoli výsledek jejího převodu. Neporovnávejte s NaN pomocí ===, protože i NaN === NaN dává false. Výsledek false z isNaN nedokazuje, že argument je číslo nebo že je konečný: také isNaN(Infinity) dává false.
Převod může místo vrácení logické hodnoty vyvolat výjimku. Argument typu Symbol nebo BigInt, například isNaN(1n), způsobí TypeError. Převod objektu může spustit jeho převodní kód a předat dál vyvolanou výjimku. Nepovažujte proto isNaN za bezpečný validátor libovolných dat.
Příklady
const values = [NaN, "hello", "42", "", null, undefined, Infinity];
for (const value of values) {
console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}Výsledek
NaN: true / true hello: true / false 42: false / false : false / false null: false / false undefined: true / false Infinity: false / false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.