RangeError

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.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Das RangeError-Objekt zeigt einen Fehler an, wenn ein Wert nicht in der Menge oder im Bereich der zulässigen Werte liegt.

In diesem Artikel

Beschreibung

Ein RangeError wird ausgelöst, wenn versucht wird, einen Wert als Argument an eine Funktion zu übergeben, die keinen Bereich zulässt, der den Wert einschließt.

Dies kann auftreten, wenn:

ein Wert übergeben wird, der nicht einer der erlaubten Zeichenfolgenwerte für String.prototype.normalize() ist, oder
wenn versucht wird, ein Array mit einer illegalen Länge mit dem Array-Konstruktor zu erstellen, oder
wenn ungültige Werte an die numerischen Methoden Number.prototype.toExponential(), Number.prototype.toFixed() oder Number.prototype.toPrecision() übergeben werden.

RangeError ist ein serialisierbares Objekt und kann daher mit structuredClone() geklont oder zwischen Arbeitern mit postMessage() kopiert werden.

RangeError ist eine Unterklasse von Error.

Konstruktor

RangeError()

Erstellt ein neues RangeError-Objekt.

Instanzeigenschaften

Übernimmt auch Instanzeigenschaften von seinem Elternteil Error.

Diese Eigenschaften sind auf RangeError.prototype definiert und werden von allen RangeError-Instanzen geteilt.

RangeError.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für RangeError-Instanzen ist der Anfangswert der RangeError-Konstruktor.

RangeError.prototype.name

Gibt den Namen für den Fehlertyp an. Für RangeError.prototype.name ist der Anfangswert "RangeError".

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
  }
}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

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

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
RangeError
Konstruktor
1. RangeError()
Vererbung
Error
Konstruktor
1. Error()
Statische Methoden
1. captureStackTrace()
2. isError()
Statische Eigenschaften
1. stackTraceLimit
Instanzmethoden
1. toString()
Instanzeigenschaften
1. cause
2. columnNumber
3. fileName
4. lineNumber
5. message
6. name
7. stack
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
AggregateError
EvalError
InternalError
ReferenceError
SyntaxError
TypeError
URIError

RangeError

In diesem Artikel

Beschreibung

Konstruktor

Instanzeigenschaften

Instanzmethoden

Beispiele

Verwendung von RangeError (für numerische Werte)

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN