Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Number.isNaN: přesný test NaN bez koerce

Number.isNaN vrátí true pouze tehdy, když je argument typu Number a má speciální hodnotu NaN.

Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Number.isNaN(number)

Number.isNaN(value) kontroluje zároveň typ Number a hodnotu NaN. Vrátí true pro NaN vzniklé neúspěšným číselným převodem nebo nedefinovanou aritmetickou operací a false pro každý jiný Number včetně Infinity a -0. Chybějící argument dá false, protože undefined není Number.

Metoda nepoužívá ToNumber: "NaN", "oops", undefined, objekty, BigInt a Symbol dají false bez převodu či TypeError. Globální isNaN se liší tím, že nejprve převádí; proto isNaN("oops") je true, ale Number.isNaN("oops") je false, a některé převody globální formy mohou vyhodit výjimku. Number.isNaN je obvykle bezpečnější test výsledku výpočtu.

Metoda existuje od ECMAScript 2015 a není konstruktorem. Příklad explicitně převede měření pomocí Number a poté označí za neplatný pouze výsledek NaN. Všimněte si, že Number("") je 0, takže Number.isNaN nenahrazuje kontrolu, zda vstupní formát povoluje prázdný text.

Příklady

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")));

Výsledek

18.5 | invalid | 0.0
true false false
true false
false false

Number.isNaN → ověření výsledku explicitního převodu měření

Zdroje