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.