CKTIS / JavaScript
SyntaxError — syntaktické chyby
SyntaxError označuje chybu při parsování kódu nebo textu, který musí dodržovat určitou syntaxi, například JSON. Poznejte rozdíl mezi chybou, která zabrání spuštění skriptu, a výjimkou vyvolanou během jeho běhu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new SyntaxError(message)
SyntaxError(message)
throw new SyntaxError(message)SyntaxError je vestavěný typ chyby ECMAScript, který dědí z Error. Signalizuje problém při parsování; nejde o samostatné Web API. Neplatný kód JavaScriptu může být například odmítnut ještě před spuštěním, zatímco JSON.parse() vyvolá tuto výjimku pro neplatný text JSON.
new SyntaxError(message) vytvoří objekt, ale nevyvolá ho; k tomu slouží throw. Parametr message je nepovinný. Také volání SyntaxError(message) bez new vytvoří objekt chyby. Výchozí hodnota name je "SyntaxError" a message popisuje problém.
Blok try...catch nemůže zachytit syntaktickou chybu, která zabrání parsování téhož skriptu: tento skript se vůbec nezačne spouštět. Může však zachytit SyntaxError vyvolaný během běhu, například při parsování textu předaného jako argument funkci JSON.parse().
V příkladu chybí po "count": hodnota JSON. Samotný kód JavaScriptu zůstává platný, takže catch může výjimku zpracovat. Kontrola instanceof SyntaxError rozpozná tento typ v rámci stejného realm; objekty z jiného realm, například z jiného okna, kontrolou projít nemusí. Neporovnávejte automaticky generované řetězce message, protože jejich znění se může mezi enginy lišit.
Příklady
try {
JSON.parse('{"count": }');
} catch (error) {
if (!(error instanceof SyntaxError)) {
throw error;
}
console.log(error.name);
}Výsledek
SyntaxError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.