RangeError() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der RangeError() Konstruktor erzeugt RangeError Objekte.

Syntax

js
new RangeError()
new RangeError(message)
new RangeError(message, options)
new RangeError(message, fileName)
new RangeError(message, fileName, lineNumber)

RangeError()
RangeError(message)
RangeError(message, options)
RangeError(message, fileName)
RangeError(message, fileName, lineNumber)

Note: RangeError() kann mit oder ohne new aufgerufen werden. Beide Aufrufe erstellen eine neue RangeError Instanz.

Parameter

message Optional

Menschlich lesbare Beschreibung des Fehlers.

options Optional

Ein Objekt mit den folgenden Eigenschaften:

cause Optional

Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Beim Abfangen und erneuten Auslösen eines Fehlers mit einer spezifischeren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übergeben.

fileName Optional

Der Name der Datei, die den Code enthält, der die Ausnahme verursacht hat.

lineNumber Optional

Die Zeilennummer des Codes, der die Ausnahme verursacht hat.

Beispiele

Verwendung von RangeError (für numerische Werte)

js
function check(n) {
  if (!(n >= -500 && n <= 500)) {
    throw new RangeError("The argument must be between -500 and 500.");
  }
}

try {
  check(2000);
} catch (error) {
  if (error instanceof RangeError) {
    // Handle the error
  }
}

Verwendung von RangeError (für nicht-numerische Werte)

js
function check(value) {
  if (!["apple", "banana", "carrot"].includes(value)) {
    throw new RangeError(
      'The argument must be an "apple", "banana", or "carrot".',
    );
  }
}

try {
  check("cabbage");
} catch (error) {
  if (error instanceof RangeError) {
    // Handle the error
  }
}

Spezifikationen

Specification
ECMAScript Language Specification
# sec-nativeerror-constructors

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch