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
- ECMAScript 2024 — NaN
- ECMAScript 2024 — The Number Type
- ECMAScript 2024 — Number.NaN
- ECMAScript 2024 — Number.isNaN ( number )
- ECMAScript 2024 — isNaN ( number )
- ECMAScript 2024 — ToNumber ( argument )
- ECMAScript 2024 — Object.is ( value1, value2 )
- ECMAScript 2024 — Number.isFinite ( number )
- NaN - JavaScript | MDN