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.