CKTIS / JavaScript
RangeError — ein Wert außerhalb des zulässigen Bereichs
RangeError ist ein integrierter ECMAScript-Fehlertyp und weist auf einen Wert außerhalb einer zulässigen Menge oder eines zulässigen Bereichs hin. Damit lassen sich ungültige Argumente signalisieren und solche Ausnahmen mit try...catch behandeln.
Version: 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 ist ein integrierter ECMAScript-Fehlertyp, dessen Instanzen von Error erben. Er weist auf einen Wert außerhalb einer zulässigen Menge oder eines zulässigen Bereichs hin; es muss sich dabei nicht ausschließlich um das Überschreiten einer numerischen Grenze handeln. RangeError ist keine Web-API-Schnittstelle.
new RangeError(message) erstellt ein Fehlerobjekt mit einer optionalen Meldung. Auch der Aufruf RangeError(message) ohne new erstellt ein neues Objekt. Das Erstellen des Fehlers allein unterbricht die Ausführung nicht: Verwende throw new RangeError(message), um eine Ausnahme auszulösen.
Einige Operationen lösen diesen Fehler automatisch aus. Zum Beispiel lehnt new Array(-1) eine negative Länge ab. Bei einem einzelnen Argument vom Typ Number verlangt der Array-Konstruktor eine ganzzahlige Länge von einschließlich 0 bis 2 ** 32 - 1. Das Lesen eines Elements hinter dem Ende eines gewöhnlichen Arrays löst für sich genommen keinen RangeError aus.
Behandle die erwartete Ausnahme mit try...catch und löse nicht zugehörige Fehler erneut aus. Im Beispiel prüft instanceof RangeError den Typ innerhalb derselben Realm-Umgebung; Objekte aus einer anderen Umgebung, etwa einem Frame, bestehen diese Prüfung möglicherweise nicht. Vergleiche keine vom Engine erzeugten Fehlermeldungen: Ihr Wortlaut ist kein plattformübergreifend verlässlicher Vertrag.
Beispiele
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Ergebnis
RangeError true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.