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

CKTIS / JavaScript

NaN: o valor especial do tipo Number e como detetá-lo

`NaN` é um valor especial do tipo `Number`. Para o detetar sem converter o argumento, usa `Number.isNaN()` em vez da função global `isNaN()`.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

NaN
Number.NaN
Number.isNaN(value)
isNaN(value)

NaN (abreviatura de «Not-a-Number») é um valor primitivo especial do tipo Number. Por exemplo, 0 / 0 e Number("oops") produzem esse valor em vez de lançar uma exceção. typeof NaN devolve "number". A propriedade global NaN e a propriedade estática Number.NaN dão acesso ao mesmo valor, que é distinto da cadeia de caracteres "NaN".

Usa Number.isNaN(value) para testar um valor. O método só devolve true para NaN e não converte o argumento. Nem == nem === consideram NaN igual a si próprio: NaN === NaN dá false. Já Object.is(NaN, Number.NaN) devolve true, porque aplica uma regra de comparação diferente.

A função global isNaN(value) tenta primeiro converter o argumento num valor do tipo Number. É por isso que isNaN("oops") devolve true, enquanto isNaN("") devolve false, pois a cadeia vazia é convertida em 0. Para valores do tipo BigInt ou Symbol, a conversão lança um TypeError; Number.isNaN() devolve false para esses valores.

Se precisares de um valor finito do tipo Number, usa Number.isFinite(value). Verificar apenas !Number.isNaN(value) não chega: esse teste também aceita valores infinitos e valores de outros tipos.

Exemplos

{
  const input = "oops";
  const value = Number(input);
  console.log(value);
  console.log(Number.isNaN(input));
  console.log(isNaN(input));
  console.log(Number.isNaN(value));
  console.log(value === NaN);
  console.log(Object.is(value, Number.NaN));
}

Resultado

NaN
false
true
true
false
true

`input` continua a ser uma cadeia de caracteres; é `Number(input)` que produz `NaN`. As duas últimas linhas da saída mostram a diferença entre `===` e `Object.is()`.

Lições relacionadas

  • JavaScript · Lição 12 · Intermédio · Versão: 3

Fontes