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í