CKTIS / JavaScript
SyntaxError — Syntaxfehler
SyntaxError weist auf einen Analysefehler in Code oder Text hin, der einer bestimmten Syntax folgen muss, etwa JSON. Erfahre, worin sich ein Fehler unterscheidet, der die Ausführung eines Skripts verhindert, und eine Ausnahme, die während der Ausführung ausgelöst wird.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new SyntaxError(message)
SyntaxError(message)
throw new SyntaxError(message)SyntaxError ist ein integrierter ECMAScript-Fehlertyp, der von Error erbt. Er signalisiert ein Problem bei der Analyse und ist keine eigenständige Web-API. Ungültiger JavaScript-Code kann beispielsweise vor der Ausführung abgelehnt werden, während JSON.parse() diese Ausnahme bei ungültigem JSON-Text auslöst.
new SyntaxError(message) erstellt ein Objekt, löst es aber nicht aus; dafür wird throw verwendet. Der Parameter message ist optional. Auch der Aufruf SyntaxError(message) ohne new erstellt ein Fehlerobjekt. Der Standardwert für name ist "SyntaxError", und message beschreibt das Problem.
Ein try...catch-Block kann keinen Syntaxfehler abfangen, der verhindert, dass dasselbe Skript geparst wird: Dieses Skript beginnt dann gar nicht erst mit der Ausführung. Er kann jedoch einen während der Ausführung ausgelösten SyntaxError abfangen, etwa einen Fehler von JSON.parse(), wenn damit als Argument übergebener Text geparst wird.
Im Beispiel fehlt nach "count": ein JSON-Wert. Der JavaScript-Code selbst ist weiterhin gültig, sodass catch die Ausnahme behandeln kann. Die Prüfung mit instanceof SyntaxError erkennt diesen Typ innerhalb derselben Realm-Umgebung; Objekte aus einer anderen Realm-Umgebung, etwa einem anderen Fenster, bestehen die Prüfung möglicherweise nicht. Vergleiche automatisch erzeugte message-Texte nicht direkt, da ihr Wortlaut je nach Engine unterschiedlich sein kann.
Beispiele
try {
JSON.parse('{"count": }');
} catch (error) {
if (!(error instanceof SyntaxError)) {
throw error;
}
console.log(error.name);
}Ergebnis
SyntaxError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.