The NaN
global property is a value representing Not-A-Number.
The NaN
global property is a value representing Not-A-Number.
function sanitize(x) {
if (isNaN(x)) {
return NaN;
}
return x;
}
console.log(sanitize("1"));
/ Expected output: "1"
console.log(sanitize("NotANumber"));
/ Expected output: NaN
The same number value as Number.NaN
.
Property attributes of NaN | |
---|---|
Writable | no |
Enumerable | no |
Configurable | no |
NaN
is a property of the global object. In other words, it is a variable in global scope.
In modern browsers, NaN
is a non-configurable, non-writable property. Even when this is not the case, avoid overriding it.
There are five different types of operations that return NaN
:
parseInt("blabla")
, Number(undefined)
, or implicit ones like Math.abs(undefined)
)Math.sqrt(-1)
)0 * Infinity
, 1 ** Infinity
, Infinity / Infinity
, Infinity - Infinity
)NaN
(e.g., 7 ** NaN
, 7 * "blabla"
) — this means NaN
is contagiousnew Date("blabla").getTime()
, "".charCodeAt(1)
)NaN
and its behaviors are not invented by JavaScript. Its semantics in floating point arithmetic (including that NaN !== NaN
) are specified by IEEE 754. NaN
's behaviors include:
NaN
is involved in a mathematical operation (but not bitwise operations), the result is usually also NaN
. (See counter-example below.)NaN
is one of the operands of any relational comparison (>
, <
, >=
, <=
), the result is always false
.NaN
compares unequal (via !==
) to any other value — including to another NaN
value.NaN
is also one of the isNaN()
to most clearly determine whether a value is NaN
— or, since NaN
is the only value that compares unequal to itself, you can perform a self-comparison like x !== x
.
NaN === NaN; / false
Number.NaN === NaN; / false
isNaN(NaN); / true
isNaN(Number.NaN); / true
Number.isNaN(NaN); / true
function valueIsNaN(v) {
return v !== v;
}
valueIsNaN(1); / false
valueIsNaN(NaN); / true
valueIsNaN(Number.NaN); / true
However, do note the difference between isNaN()
and Number.isNaN()
: the former will return true
if the value is currently NaN
, or if it is going to be NaN
after it is coerced to a number, while the latter will return true
only if the value is currently NaN
:
isNaN("hello world"); / true
Number.isNaN("hello world"); / false
For the same reason, using a BigInt value will throw an error with isNaN()
and not with Number.isNaN()
:
isNaN(1n); / TypeError: Conversion from 'BigInt' to 'number' is not allowed.
Number.isNaN(1n); / false
Additionally, some array methods cannot find NaN
, while others can. Namely, the index-finding ones (includes()
) can:
const arr = [2, 4, NaN, 12];
arr.indexOf(NaN); / -1
arr.includes(NaN); / true
/ Methods accepting a properly defined predicate can always find NaN
arr.findIndex((n) => Number.isNaN(n)); / 2
For more information about NaN
and its comparison, see typed arrays.
const f2b = (x) => new Uint8Array(new Float64Array([x]).buffer);
const b2f = (x) => new Float64Array(x.buffer)[0];
/ Get a byte representation of NaN
const n = f2b(NaN);
const m = f2b(NaN);
/ Change the sign bit, which doesn't matter for NaN
n[7] += 2 ** 7;
/ n[0] += 2**7; for big endian processors
const nan2 = b2f(n);
console.log(nan2); / NaN
console.log(Object.is(nan2, NaN)); / true
console.log(f2b(NaN)); / Uint8Array(8) [0, 0, 0, 0, 0, 0, 248, 127]
console.log(f2b(nan2)); / Uint8Array(8) [0, 0, 0, 0, 0, 0, 248, 255]
/ Change the first bit, which is the least significant bit of the mantissa and doesn't matter for NaN
m[0] = 1;
/ m[7] = 1; for big endian processors
const nan3 = b2f(m);
console.log(nan3); / NaN
console.log(Object.is(nan3, NaN)); / true
console.log(f2b(NaN)); / Uint8Array(8) [0, 0, 0, 0, 0, 0, 248, 127]
console.log(f2b(nan3)); / Uint8Array(8) [1, 0, 0, 0, 0, 0, 248, 127]
NaN
propagates through mathematical operations, so it's usually sufficient to test for NaN
once at the end of calculation to detect error conditions. The only case where NaN
gets silently escaped is when using exponentiation with an exponent of 0
, which immediately returns 1
without testing the base's value.
NaN ** 0 === 1; / true
Specification |
---|
ECMAScript® 2026 Language Specification # sec-value-properties-of-the-global-object-nan |