Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.NaN: valor Number «não é um número»

Number.NaN é o valor especial de Number para um resultado numérico inválido ou indeterminado e é o mesmo valor que o NaN global.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

Number.NaN

Number.NaN é o valor NaN do tipo Number, idêntico ao NaN global. Pode resultar de uma conversão numérica falhada ou de uma operação como 0 / 0. Não é uma exceção e ler a propriedade não lança; muitas operações numéricas posteriores com NaN também produzem NaN.

NaN é o único valor JavaScript diferente de si próprio com == e ===, por isso value === Number.NaN é sempre falso. Usa Number.isNaN(value) sem coerção ou Object.is(value, Number.NaN). typeof Number.NaN é "number"; comparações de ordem com NaN são falsas e JSON.stringify escreve NaN em arrays e propriedades de objetos como null.

A propriedade existe desde ECMAScript 1 e não é gravável, enumerável nem configurável. O exemplo devolve Number.NaN como resultado explícito de uma análise falhada de leitura e contrasta testes corretos e incorretos. Um resultado de erro separado costuma ser mais claro numa API pública porque NaN pode propagar-se em cálculos ou mudar de significado ao serializar.

O NaN global é uma propriedade do objeto global com o mesmo valor Number que Number.NaN; compará-los por identidade com === continua a dar false, porque qualquer valor NaN é diferente de si próprio. A propriedade global não é gravável, enumerável nem configurável, mas o identificador NaN pode ser ocultado por uma ligação local, pelo que Number.NaN pode ser menos ambíguo. Na lição de origem, uma idade vazia é convertida explicitamente no NaN global e depois rejeitada por Number.isInteger().

Exemplos

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

Resultado

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

Number.NaN → resultado de falha explícito e teste correto de NaN

Fontes