Home Original page

RangeError() Konstruktor - JavaScript | MDN

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Der RangeError() Konstruktor erstellt 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)

Hinweis: RangeError() kann mit oder ohne new aufgerufen werden. Beide erzeugen eine neue RangeError Instanz.

Parameter

message Optional

Menschlich lesbare Beschreibung des Fehlers.

options Optional

Ein Objekt, das die folgenden Eigenschaften hat:

cause Optional

Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Wenn Sie einen Fehler abfangen und mit einer spezifischeren oder nützlicheren Fehlermeldung erneut werfen, kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übergeben.

fileName Optional Nicht standardisiert

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

lineNumber Optional Nicht standardisiert

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

Spezifikation
ECMAScript® 2026 Language Specification
# sec-nativeerror-constructors

Browser-Kompatibilität

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.