CKTIS / JavaScript
Number.NaN: hodnota Number „není číslo“
Number.NaN je speciální hodnota Number pro neplatný nebo neurčitý číselný výsledek a je totožná s globálním NaN.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
Number.NaNNumber.NaN je hodnota NaN typu Number, totožná s globálním NaN. Může vzniknout neúspěšným číselným převodem nebo operací jako 0 / 0. Není výjimkou a čtení vlastnosti nic nevyhodí; mnoho následných číselných operací s NaN opět vytvoří NaN.
NaN je jediná hodnota JavaScriptu, která se nerovná sama sobě ani přes ==, ani přes ===, takže value === Number.NaN je vždy nepravda. Testujte bez koerce pomocí Number.isNaN(value) nebo Object.is(value, Number.NaN). typeof Number.NaN je "number"; uspořádací porovnání s NaN jsou nepravdivá a JSON.stringify zapisuje NaN v polích a vlastnostech objektů jako null.
Vlastnost existuje od ECMAScript 1 a není zapisovatelná, výčtová ani konfigurovatelná. Příklad vrací Number.NaN jako explicitní výsledek neúspěšného zpracování měření a porovnává správné a chybné testy. Ve veřejném API bývá jasnější samostatný chybový výsledek, protože NaN se může tiše šířit výpočty nebo změnit význam při serializaci.
Globální NaN je vlastnost globálního objektu se stejnou hodnotou Number jako Number.NaN; porovnání jejich identity pomocí === je přesto false, protože každá hodnota NaN se nerovná sama sobě. Globální vlastnost není zapisovatelná, výčtová ani konfigurovatelná, identifikátor NaN však může zastínit lokální vazba, takže Number.NaN může být jednoznačnější. Ve zdrojové lekci se prázdný věk výslovně převede na globální NaN a následně jej odmítne Number.isInteger().
Příklady
function parseMeasurement(text) {
const value = Number(text);
return Number.isNaN(value) ? Number.NaN : value;
}
const failed = parseMeasurement("bad");
console.log(Number.isNaN(failed), failed === Number.NaN, Object.is(failed, Number.NaN));
console.log(typeof Number.NaN, Number.NaN === NaN);
console.log(JSON.stringify({ value: Number.NaN }));
const descriptor = Object.getOwnPropertyDescriptor(Number, "NaN");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);Výsledek
true false true
number false
{"value":null}
false false falseNumber.NaN → explicitní chybový výsledek a správný test NaN