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

CKTIS / JavaScript

isNaN() — verificar NaN após a conversão

A função global isNaN(value) converte primeiro o argumento para Number e, em seguida, verifica se o resultado é NaN. Ao contrário de Number.isNaN(), pode devolver true para cadeias de caracteres ou undefined, pelo que não é um teste geral para saber se um valor é um número válido.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

isNaN(value)

isNaN(value) é uma função global de ECMAScript, não uma API do navegador. Aplica a operação ToNumber ao argumento e devolve true se o resultado for NaN; caso contrário, devolve false. NaN é um valor especial do tipo Number que representa um resultado que não é um número válido, como o resultado de 0 / 0.

A conversão é importante: isNaN("hello") e isNaN(undefined) devolvem true, mas isNaN("42"), isNaN("") e isNaN(null) devolvem false. A cadeia vazia e null são convertidos para 0. Chamar isNaN() sem argumentos equivale a passar undefined e devolve true.

Number.isNaN(value) não efetua conversões: só devolve true para o valor Number NaN. Utilize-a quando quiser verificar o próprio valor, em vez do resultado da sua conversão. Não compare com NaN usando ===, porque até NaN === NaN produz false. Um resultado false de isNaN não prova que o argumento seja um número nem que seja finito: isNaN(Infinity) também produz false.

A conversão pode lançar uma exceção em vez de devolver um valor booleano. Um argumento do tipo Symbol ou BigInt, como isNaN(1n), provoca um TypeError. A conversão de um objeto pode executar o respetivo código de conversão e propagar uma exceção lançada. Por isso, não trate isNaN como um validador seguro para dados arbitrários.

Exemplos

const values = [NaN, "hello", "42", "", null, undefined, Infinity];

for (const value of values) {
  console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}

Resultado

NaN: true / true
hello: true / false
42: false / false
: false / false
null: false / false
undefined: true / false
Infinity: false / false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes