CKTIS / JavaScript
NaN: el valor especial de tipo Number y cómo detectarlo
`NaN` es un valor especial del tipo `Number`. Para detectarlo sin convertir el argumento, usa `Number.isNaN()` en lugar de la función global `isNaN()`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
NaN
Number.NaN
Number.isNaN(value)
isNaN(value)NaN (abreviatura de «Not-a-Number») es un valor primitivo especial del tipo Number. Por ejemplo, 0 / 0 y Number("oops") producen este valor en vez de lanzar una excepción. typeof NaN devuelve "number". La propiedad global NaN y la propiedad estática Number.NaN dan acceso al mismo valor, que es distinto de la cadena "NaN".
Usa Number.isNaN(value) para comprobar un valor. El método solo devuelve true para NaN y no convierte el argumento. Ni == ni === consideran que NaN sea igual a sí mismo: NaN === NaN da false. En cambio, Object.is(NaN, Number.NaN) devuelve true porque aplica una regla de comparación distinta.
La función global isNaN(value) primero intenta convertir el argumento a un valor de tipo Number. Por eso isNaN("oops") devuelve true, mientras que isNaN("") devuelve false porque la cadena vacía se convierte en 0. Para valores de tipo BigInt o Symbol, esa conversión lanza un TypeError; Number.isNaN() devuelve false para esos valores.
Si necesitas un valor finito de tipo Number, usa Number.isFinite(value). Comprobar solo !Number.isNaN(value) no basta: también acepta valores infinitos y valores de otros tipos.
Ejemplos
{
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` sigue siendo una cadena; lo que produce `NaN` es `Number(input)`. Las dos últimas líneas de la salida muestran la diferencia entre `===` y `Object.is()`.
Lecciones relacionadas
- JavaScript · Lección 12 · Intermedio · Versión: 3
Fuentes
- 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