База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Number.NaN: стойността Number „не е число“

Number.NaN е специалната стойност Number за невалиден или неопределен числов резултат и е същата стойност като глобалното NaN.

Версия: ECMAScript 1 onward; example target: Node.js 24.22.2

Синтаксис

Number.NaN

Number.NaN е стойността NaN от тип Number, идентична с глобалното NaN. Може да възникне от неуспешно числово преобразуване или операция като 0 / 0. Не е изключение и четенето на свойството не хвърля; много следващи числови операции с NaN също дават NaN.

NaN е единствената JavaScript стойност, която не е равна на себе си нито с ==, нито с ===, затова value === Number.NaN винаги е false. Проверявай без преобразуване с Number.isNaN(value) или Object.is(value, Number.NaN). typeof Number.NaN е "number"; сравненията за ред с NaN са false, а JSON.stringify записва NaN в масиви и свойства на обекти като null.

Свойството съществува от ECMAScript 1 и не е writable, enumerable или configurable. Примерът връща Number.NaN като явен резултат от неуспешно парсване на показание и сравнява правилни и грешни проверки. В публичен API отделен резултат за грешка често е по-ясен, защото NaN може тихо да се разпространява или да промени смисъла си при сериализация.

Глобалното NaN е свойство на глобалния обект със същата стойност Number като Number.NaN; сравнението им за идентичност с === все пак е false, защото всяка стойност NaN не е равна на себе си. Глобалното свойство не е writable, enumerable или configurable, но локално обвързване може да засенчи идентификатора NaN, затова Number.NaN може да е по-еднозначно. В изходния урок празна възраст изрично се преобразува в глобалното NaN, след което Number.isInteger() я отхвърля.

Примери

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

Резултат

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

Number.NaN → явен резултат за грешка и правилна проверка за NaN

Източници