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 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® 2025 Language Specification
# sec-native-error-types-used-in-this-standard-referenceerror

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
ReferenceError
ReferenceError() constructor
ReferenceError is serializable

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Siehe auch