ReferenceError

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.

Das ReferenceError-Objekt repräsentiert einen Fehler, wenn auf eine Variable verwiesen wird, die im aktuellen Geltungsbereich nicht existiert (oder noch nicht initialisiert wurde).

ReferenceError ist ein serialisierbares Objekt, daher kann es mit structuredClone() geklont oder zwischen Workers mit postMessage() kopiert werden.

ReferenceError ist eine Unterklasse von Error.

Konstruktor

ReferenceError()

Erstellt ein neues ReferenceError-Objekt.

Instanz-Eigenschaften

Erbt auch Instanz-Eigenschaften von seinem übergeordneten Objekt Error.

Diese Eigenschaften sind auf ReferenceError.prototype definiert und werden von allen ReferenceError-Instanzen gemeinsam genutzt.

ReferenceError.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für ReferenceError-Instanzen ist der anfängliche Wert der ReferenceError-Konstruktor.

ReferenceError.prototype.name

Repräsentiert den Namen für den Fehlertyp. Für ReferenceError.prototype.name ist der anfängliche Wert "ReferenceError".

Instanz-Methoden

Erbt Instanz-Methoden von seinem übergeordneten Objekt Error.

Beispiele

Einen ReferenceError abfangen

js
try {
  let a = undefinedVariable;
} catch (e) {
  console.log(e instanceof ReferenceError); // true
  console.log(e.message); // "undefinedVariable is not defined"
  console.log(e.name); // "ReferenceError"
  console.log(e.stack); // Stack of the error
}

Einen ReferenceError erstellen

js
try {
  throw new ReferenceError("Hello");
} catch (e) {
  console.log(e instanceof ReferenceError); // true
  console.log(e.message); // "Hello"
  console.log(e.name); // "ReferenceError"
  console.log(e.stack); // Stack of the error
}

Spezifikationen

Specification
ECMAScript Language Specification
# sec-native-error-types-used-in-this-standard-referenceerror

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch