CKTIS / JavaScript
Number.NaN: valor Number «no es un número»
Number.NaN es el valor especial de Number para un resultado numérico inválido o indeterminado y es el mismo valor que el NaN global.
Versión: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaxis
Number.NaNNumber.NaN es el valor NaN de tipo Number, idéntico al NaN global. Puede surgir de una conversión numérica fallida o de una operación como 0 / 0. No es una excepción y leer la propiedad no lanza; muchas operaciones numéricas posteriores con NaN también producen NaN.
NaN es el único valor de JavaScript desigual a sí mismo tanto con == como con ===, así que value === Number.NaN siempre es falso. Usa Number.isNaN(value) sin coerción u Object.is(value, Number.NaN). typeof Number.NaN es "number"; las comparaciones de orden con NaN son falsas y JSON.stringify escribe NaN en arrays y propiedades de objetos como null.
La propiedad existe desde ECMAScript 1 y no es escribible, enumerable ni configurable. El ejemplo devuelve Number.NaN como resultado explícito de analizar una lectura fallida y contrasta pruebas correctas e incorrectas. Un resultado de error separado suele ser más claro en una API pública porque NaN puede propagarse en cálculos o cambiar de significado al serializarse.
El NaN global es una propiedad del objeto global con el mismo valor Number que Number.NaN; compararlos por identidad con === aun así da false, porque todo valor NaN es desigual a sí mismo. La propiedad global no es escribible, enumerable ni configurable, pero una vinculación local puede ocultar el identificador NaN, por lo que Number.NaN puede ser menos ambiguo. En la lección fuente una edad vacía se convierte explícitamente en el NaN global y después Number.isInteger() la rechaza.
Ejemplos
function parseMeasurement(text) {
const value = Number(text);
return Number.isNaN(value) ? Number.NaN : value;
}
const failed = parseMeasurement("bad");
console.log(Number.isNaN(failed), failed === Number.NaN, Object.is(failed, Number.NaN));
console.log(typeof Number.NaN, Number.NaN === NaN);
console.log(JSON.stringify({ value: Number.NaN }));
const descriptor = Object.getOwnPropertyDescriptor(Number, "NaN");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);Resultado
true false true
number false
{"value":null}
false false falseNumber.NaN → resultado de fallo explícito y prueba correcta de NaN