SyntaxError() Konstruktor
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Der SyntaxError() Konstruktor erstellt SyntaxError Objekte.
Syntax
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)
Hinweis:
SyntaxError() kann mit oder ohne new aufgerufen werden. Beide Varianten erzeugen eine neue Instanz von SyntaxError.
Parameter
messageOptional-
Menschlich lesbare Beschreibung des Fehlers
optionsOptional-
Ein Objekt, das die folgenden Eigenschaften hat:
causeOptional-
Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Beim Abfangen und erneuten Werfen eines Fehlers mit einer spezifischeren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übermitteln.
fileNameOptional Nicht standardisiert-
Der Name der Datei, die den Code enthält, der die Ausnahme verursacht hat
lineNumberOptional Nicht standardisiert-
Die Zeilennummer des Codes, der die Ausnahme verursacht hat
Beispiele
Fangen eines SyntaxError
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
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
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-nativeerror-constructors |