KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

RangeError — een waarde buiten het toegestane bereik

RangeError is een ingebouwd ECMAScript-fouttype dat een waarde buiten een toegestane verzameling of bereik aangeeft. Je kunt het gebruiken om ongeldige argumenten te signaleren en zulke uitzonderingen met try...catch af te handelen.

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

new RangeError(message)
RangeError(message)
throw new RangeError(message)

RangeError is een ingebouwd ECMAScript-fouttype waarvan de instanties overerven van Error. Het geeft een waarde buiten een toegestane verzameling of bereik aan; dat hoeft niet alleen om het overschrijden van een numerieke grens te gaan. Het is geen Web API-interface.

new RangeError(message) maakt een foutobject met een optioneel bericht. Ook de aanroep RangeError(message) zonder new maakt een nieuw object. Alleen het maken van de fout onderbreekt de uitvoering niet: gebruik throw new RangeError(message) om een uitzondering te gooien.

Sommige bewerkingen gooien deze fout automatisch. Zo weigert new Array(-1) een negatieve lengte. Bij één argument van het type Number vereist de Array-constructor een gehele lengte van 0 tot en met 2 ** 32 - 1. Het lezen van een element voorbij het einde van een gewone array veroorzaakt op zichzelf geen RangeError.

Handel de verwachte uitzondering af met try...catch en gooi niet-gerelateerde fouten opnieuw. In het voorbeeld controleert instanceof RangeError het type binnen dezelfde realm; objecten uit een andere realm, zoals een frame, kunnen deze test niet doorstaan. Vergelijk geen door de engine gegenereerde foutmeldingen: de formulering ervan is geen portable contract.

Voorbeelden

try {
  new Array(-1);
} catch (error) {
  if (!(error instanceof RangeError)) throw error;
  console.log(error.name);
  console.log(error instanceof Error);
}

Resultaat

RangeError
true

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