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 erstellt RangeError Objekte.
Syntax
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
messageOptional-
Menschlich lesbare Beschreibung des Fehlers.
optionsOptional-
Ein Objekt, das die folgenden Eigenschaften hat:
causeOptional-
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.
fileNameOptional Nicht standardisiert-
Der Name der Datei, die den Code enthält, der die Ausnahme verursacht hat.
lineNumberOptional Nicht standardisiert-
Die Zeilennummer des Codes, der die Ausnahme verursacht hat.
Beispiele
Verwendung von RangeError (für numerische Werte)
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)
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® 2026 Language Specification # sec-nativeerror-constructors |