KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

isNaN() — NaN controleren na conversie

De globale functie isNaN(value) converteert eerst het argument naar Number en controleert daarna of het resultaat NaN is. Anders dan Number.isNaN() kan de functie ook voor tekenreeksen of undefined true opleveren en is ze dus geen algemene test voor een geldig getal.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

isNaN(value)

isNaN(value) is een globale ECMAScript-functie en geen browser-API. De functie past de bewerking ToNumber toe op het argument en geeft true terug als het resultaat NaN is; anders geeft ze false terug. NaN is een speciale waarde van het type Number die een resultaat aanduidt dat geen geldig getal is, zoals het resultaat van 0 / 0.

De conversie is van belang: isNaN("hello") en isNaN(undefined) geven true terug, maar isNaN("42"), isNaN("") en isNaN(null) geven false terug. De lege tekenreeks en null worden naar 0 geconverteerd. isNaN() aanroepen zonder argument werkt alsof undefined wordt doorgegeven en geeft true terug.

Number.isNaN(value) voert geen conversie uit: de functie geeft alleen voor de Number-waarde NaN true terug. Gebruik deze functie als je de waarde zelf wilt controleren, niet het resultaat van de conversie ervan. Vergelijk niet met NaN met ===, want zelfs NaN === NaN levert false op. Een resultaat false van isNaN bewijst niet dat het argument een getal is of eindig is: ook isNaN(Infinity) levert false op.

De conversie kan een uitzondering veroorzaken in plaats van een boolean terug te geven. Een argument van het type Symbol of BigInt, zoals isNaN(1n), veroorzaakt een TypeError. Bij de conversie van een object kan de conversiecode ervan worden uitgevoerd en kan een opgeworpen uitzondering worden doorgegeven. Beschouw isNaN daarom niet als een veilige validator voor willekeurige gegevens.

Voorbeelden

const values = [NaN, "hello", "42", "", null, undefined, Infinity];

for (const value of values) {
  console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}

Resultaat

NaN: true / true
hello: true / false
42: false / false
: false / false
null: false / false
undefined: true / false
Infinity: false / false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen