Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Number.NaN: hodnota Number „nie je číslo“

Number.NaN je špeciálna hodnota Number pre neplatný alebo neurčitý číselný výsledok a je totožná s globálnym NaN.

Verzia: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

Number.NaN

Number.NaN je hodnota NaN typu Number, totožná s globálnym NaN. Môže vzniknúť neúspešným číselným prevodom alebo operáciou ako 0 / 0. Nie je výnimkou a čítanie vlastnosti nič nevyhodí; mnoho následných číselných operácií s NaN opäť vytvorí NaN.

NaN je jediná hodnota JavaScriptu, ktorá sa nerovná sama sebe ani cez ==, ani cez ===, takže value === Number.NaN je vždy nepravda. Testujte bez koercie pomocou Number.isNaN(value) alebo Object.is(value, Number.NaN). typeof Number.NaN je "number"; usporiadacie porovnania s NaN sú nepravdivé a JSON.stringify zapisuje NaN v poliach a vlastnostiach objektov ako null.

Vlastnosť existuje od ECMAScript 1 a nie je zapisovateľná, vymenovateľná ani konfigurovateľná. Príklad vracia Number.NaN ako explicitný výsledok neúspešného spracovania merania a porovnáva správne a chybné testy. Vo verejnom API býva jasnejší samostatný chybový výsledok, pretože NaN sa môže ticho šíriť výpočtami alebo zmeniť význam pri serializácii.

Globálne NaN je vlastnosť globálneho objektu s rovnakou hodnotou Number ako Number.NaN; porovnanie ich identity pomocou === je napriek tomu false, pretože každá hodnota NaN sa nerovná sama sebe. Globálna vlastnosť nie je zapisovateľná, vymenovateľná ani konfigurovateľná, identifikátor NaN však môže zatieniť lokálna väzba, takže Number.NaN môže byť jednoznačnejšie. V zdrojovej lekcii sa prázdny vek výslovne prevedie na globálne NaN a následne ho odmietne Number.isInteger().

Prí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ýsledok

true false true
number false
{"value":null}
false false false

Number.NaN → explicitný chybový výsledok a správny test NaN

Zdroje