NaN en JavaScript: guía rápida para desarrolladores

NaN (Not a Number) es el valor que JavaScript devuelve cuando una operación numérica no puede producir un número válido, como 0 / 0 o Number("WTF"). Es de tipo number y es el único valor que no es igual a sí mismo, así que para detectarlo se usa Number.isNaN() y no ===.

Esta es una chuleta (cheatsheet) con todo lo que hay que saber sobre NaN en JavaScript.

Propiedades y funciones

JavaScript tiene la propiedad global NaN y dos funciones para verificar valores NaN.

Propiedad global NaN

• Representa Not a Number (No es un Número)
• Es el resultado de expresiones que deberían producir un número pero fallaron (por ejemplo, Math.sqrt(-1))
• Es de tipo número: typeof NaN === 'number'
• NaN es distinto de NaN: NaN === NaN es false

Función isNaN()

• Verifica si el valor es NaN después de convertirlo a un número
• Devuelve true si el valor es NaN
• Devuelve true si el valor no se puede convertir a un número (como "Baumann")
• Devuelve false si el valor se puede convertir a un número (como string: "36")
• Devuelve false si el valor es un número válido (como number: 36)

Función Number.isNaN()

• Sin convertir el valor a un número, verifica si el valor es NaN
• Devuelve true si el valor es NaN
• Devuelve false para el resto de los valores

isNaN() frente a Number.isNaN()

La diferencia está en la conversión previa: isNaN() convierte el valor a número antes de comprobarlo y Number.isNaN() no.

Generando NaN

Hay varias maneras de producir un valor NaN.

Convertir a número

Convertir un valor a un número que no se puede convertir a un número resulta en NaN.

Number("WTF");

parseInt("Baumann");

parseFloat("Rambito.js");

No es un número real

Hacer una operación matemática donde el resultado no es un número real resulta en NaN.

0 / 0;

Math.sqrt(-1);

Infinity - Infinity;

Operación con NaN

Hacer una operación matemática con NaN resulta en NaN.

1 * NaN;

2 + NaN;

NaN / NaN;

Forma indeterminada

Operaciones que están en formas indefinidas producen NaN.

undefined * 2;

undefined + undefined;

Operaciones con cadena de texto

Hacer una operación con un string que no se puede convertir a un número produce NaN, excepto las operaciones de suma, que unen los valores.

"Rambito.js" * 2; // => NaN

"Hola" + 2; // => "Hola2"

Extra 🚀

Fuentes

• NaN, isNaN() y Number.isNaN(), en MDN.
• isNaN ( number ) y Number.isNaN ( number ), las definiciones de la especificación de ECMAScript.