CKTIS / JavaScript
Number.isNaN: teste exato de NaN sem coerção
Number.isNaN devolve true apenas quando o argumento tem o tipo Number e é o valor especial NaN.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
Number.isNaN(number)Number.isNaN(value) verifica simultaneamente o tipo Number e o valor NaN. Devolve true para NaN produzido por uma conversão numérica falhada ou operação aritmética indefinida e false para qualquer outro Number, incluindo Infinity e -0. A ausência de argumento dá false, pois undefined não é Number.
O método não aplica ToNumber: "NaN", "oops", undefined, objetos, BigInt e Symbol produzem false sem conversão nem TypeError. O isNaN global difere porque converte primeiro; por isso isNaN("oops") é true, mas Number.isNaN("oops") é false, e algumas conversões da forma global podem lançar. Number.isNaN é normalmente o teste mais seguro para o resultado de um cálculo.
O método existe desde ECMAScript 2015 e não é construtor. O exemplo converte explicitamente leituras com Number e depois marca apenas um resultado NaN como inválido. Repara que Number("") é 0, portanto Number.isNaN não substitui a verificação de que o formato permite texto vazio.
Exemplos
function parseReading(text) {
const value = Number(text);
return Number.isNaN(value) ? "invalid" : value.toFixed(1);
}
console.log(["18.5", "oops", ""].map(parseReading).join(" | "));
console.log(Number.isNaN(NaN), Number.isNaN("NaN"), Number.isNaN());
console.log(isNaN("oops"), Number.isNaN("oops"));
console.log(Number.isNaN(1n), Number.isNaN(Symbol("x")));Resultado
18.5 | invalid | 0.0 true false false true false false false
Number.isNaN → validação do resultado da conversão explícita de leituras