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 Varianten erzeugen eine neue SyntaxError-Instanz.

Parameter

message Optional

Eine verständliche Beschreibung des Fehlers

options Optional

Ein Objekt mit den folgenden Eigenschaften:

cause Optional

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

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

Abfangen eines SyntaxError

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
}

Erstellen eines SyntaxError

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-nativeerror-constructors

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch