SyntaxError() Konstruktor

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.

Der SyntaxError() Konstruktor erstellt SyntaxError Objekte.

Syntax

js
new SyntaxError()
new SyntaxError(message)
new SyntaxError(message, options)
new SyntaxError(message, fileName)
new SyntaxError(message, fileName, lineNumber)

SyntaxError()
SyntaxError(message)
SyntaxError(message, options)
SyntaxError(message, fileName)
SyntaxError(message, fileName, lineNumber)

Note: SyntaxError() kann mit oder ohne new aufgerufen werden. Beide erzeugen eine neue SyntaxError Instanz.

Parameter

message Optional

Menschlich lesbare Beschreibung des Fehlers

options Optional

Ein Objekt, das die folgenden Eigenschaften enthält:

cause Optional

Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Beim Auffangen und erneuten Werfen eines Fehlers mit einer spezifischeren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übergeben.

fileName Optional Nicht standardisiert

Der Name der Datei, die den Code enthält, der die Ausnahme verursacht hat

lineNumber Optional Nicht standardisiert

Die Zeilennummer des Codes, der die Ausnahme verursacht hat

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® 2026 Language Specification
# sec-nativeerror-constructors

Browser-Kompatibilität

Siehe auch