RangeError

Beschreibung

Ein RangeError wird ausgelst, wenn versucht wird, einen Wert als Argument an eine Funktion zu bergeben, die keinen Bereich zulsst, der den Wert einschliet.

Dies kann auftreten, wenn:

• ein Wert bergeben wird, der nicht einer der erlaubten Zeichenfolgenwerte fr String.prototype.normalize() ist, oder
• wenn versucht wird, ein Array mit einer illegalen Lnge mit dem Array-Konstruktor zu erstellen, oder
• wenn ungltige 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. Fr RangeError-Instanzen ist der Anfangswert der RangeError-Konstruktor.

RangeError.prototype.name

Gibt den Namen fr den Fehlertyp an. Fr RangeError.prototype.name ist der Anfangswert "RangeError".

Instanzmethoden

bernimmt Instanzmethoden von seinem Elternteil Error.

Beispiele

Verwendung von RangeError (fr 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 (fr 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

Browser-Kompatibilitt

Siehe auch

• Error
• Array
• Number.prototype.toExponential()
• Number.prototype.toFixed()
• Number.prototype.toPrecision()
• String.prototype.normalize()