RangeError

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

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

Beschreibung

EinRangeError 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ürString.prototype.normalize() ist, oder
wenn versucht wird, ein Array mit einer illegalen Länge mit demArray-Konstruktor zu erstellen, oder
wenn ungültige Werte an die numerischen MethodenNumber.prototype.toExponential(),Number.prototype.toFixed() oderNumber.prototype.toPrecision() übergeben werden.

RangeError ist einserialisierbares Objekt und kann daher mitstructuredClone() geklont oder zwischenArbeitern mitpostMessage() kopiert werden.

RangeError ist eine Unterklasse vonError.

Konstruktor

RangeError(): Erstellt ein neuesRangeError-Objekt.

Instanzeigenschaften

Übernimmt auch Instanzeigenschaften von seinem ElternteilError.

Diese Eigenschaften sind aufRangeError.prototype definiert und werden von allenRangeError-Instanzen geteilt.

RangeError.prototype.constructor: Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. FürRangeError-Instanzen ist der Anfangswert derRangeError-Konstruktor.
RangeError.prototype.name: Gibt den Namen für den Fehlertyp an. FürRangeError.prototype.name ist der Anfangswert"RangeError".

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