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.

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

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

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

ReferenceError ist eine Unterklasse von Error.

Konstruktor

ReferenceError()

Erstellt ein neues ReferenceError-Objekt.

Instanzeigenschaften

Erbt auch Instanzeigenschaften von seinem Elternteil Error.

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

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 die Art des Fehlers. Für ReferenceError.prototype.name ist der anfängliche Wert "ReferenceError".

Instanzmethoden

Erbt Instanzmethoden von seinem Elternteil 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® 2026 Language Specification
# sec-native-error-types-used-in-this-standard-referenceerror

Browser-Kompatibilität

Siehe auch