KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Number.NaN: de Number-waarde „geen getal”

Number.NaN is de speciale Number-waarde voor een ongeldig of onbepaald numeriek resultaat en is dezelfde waarde als globale NaN.

Versie: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

Number.NaN

Number.NaN is de NaN-waarde van het type Number, identiek aan globale NaN. Ze kan ontstaan door een mislukte getalconversie of een bewerking als 0 / 0. Het is geen exceptie en het lezen van de eigenschap werpt niet; veel volgende numerieke bewerkingen met NaN produceren ook NaN.

NaN is de enige JavaScript-waarde die onder zowel == als === ongelijk is aan zichzelf, dus value === Number.NaN is altijd onwaar. Test zonder coercion met Number.isNaN(value) of Object.is(value, Number.NaN). typeof Number.NaN is "number"; ordeningsvergelijkingen met NaN zijn onwaar en JSON.stringify schrijft NaN in arrays en objecteigenschappen als null.

De eigenschap bestaat sinds ECMAScript 1 en is niet schrijfbaar, niet opsombaar en niet configureerbaar. Het voorbeeld retourneert Number.NaN als expliciet resultaat van mislukte parsing van een meting en vergelijkt juiste en onjuiste tests. Een afzonderlijk foutresultaat is vaak duidelijker in een publieke API, omdat NaN zich stil kan verspreiden of bij serialisatie van betekenis kan veranderen.

Globale NaN is een eigenschap van het globale object met dezelfde Number-waarde als Number.NaN; een identiteitsvergelijking met === is toch false, omdat elke NaN-waarde ongelijk is aan zichzelf. De globale eigenschap is niet schrijfbaar, niet opsombaar en niet configureerbaar, maar een lokale binding kan de identifier NaN overschaduwen, zodat Number.NaN minder dubbelzinnig kan zijn. In de bronles wordt een lege leeftijd expliciet omgezet in globale NaN en daarna door Number.isInteger() afgewezen.

Voorbeelden

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);

Resultaat

true false true
number false
{"value":null}
false false false

Number.NaN → expliciet foutresultaat en correcte NaN-test

Bronnen