SyntaxError

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 SyntaxError-Objekt repräsentiert einen Fehler, der auftritt, wenn syntaktisch ungültiger Code interpretiert wird. Dieser Fehler wird ausgelöst, wenn die JavaScript-Engine beim Parsen von Code auf Token oder eine Token-Reihenfolge stößt, die nicht mit der Syntax der Sprache übereinstimmen.

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

SyntaxError ist eine Unterklasse von Error.

Konstruktor

SyntaxError()

Erstellt ein neues SyntaxError-Objekt.

Instanz-Eigenschaften

Erbt auch Instanz-Eigenschaften von seinem Elternteil Error.

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

SyntaxError.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für SyntaxError-Instanzen ist der Anfangswert der SyntaxError-Konstruktor.

SyntaxError.prototype.name

Repräsentiert den Namen des Fehlertyps. Für SyntaxError.prototype.name ist der Anfangswert "SyntaxError".

Instanz-Methoden

Erbt Instanz-Methoden von seinem Elternteil Error.

Beispiele

Einen SyntaxError abfangen

js
try {
  eval("hoo bar");
} catch (e) {
  console.log(e instanceof SyntaxError); // true
  console.log(e.message);
  console.log(e.name); // "SyntaxError"
  console.log(e.stack); // Stack of the error
}

Einen SyntaxError erstellen

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch