CKTIS / JavaScript
SyntaxError — błąd składni
SyntaxError oznacza błąd analizy składniowej kodu lub tekstu wymagającego określonej składni, na przykład JSON. Poznaj różnicę między błędem blokującym wykonanie skryptu a wyjątkiem zgłoszonym podczas jego działania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new SyntaxError(message)
SyntaxError(message)
throw new SyntaxError(message)SyntaxError to wbudowany typ błędu ECMAScript, dziedziczący po Error. Sygnalizuje problem z analizą składniową; nie jest osobnym Web API. Przykładowo niepoprawny kod JavaScript może zostać odrzucony przed wykonaniem, a JSON.parse() zgłasza taki wyjątek dla niepoprawnego tekstu JSON.
new SyntaxError(message) tworzy obiekt, ale go nie zgłasza; służy do tego throw. Parametr message jest opcjonalny. Wywołanie SyntaxError(message) bez new również tworzy obiekt błędu. Domyślna wartość name to "SyntaxError", a komunikat message opisuje problem.
Blok try...catch nie przechwyci błędu składni uniemożliwiającego analizę tego samego skryptu: taki skrypt w ogóle nie rozpocznie wykonania. Może jednak przechwycić SyntaxError zgłoszony podczas działania, na przykład przez JSON.parse() analizujące tekst przekazany jako argument.
W przykładzie po "count": brakuje wartości JSON. Kod JavaScript pozostaje poprawny, więc catch może obsłużyć wyjątek. Test instanceof SyntaxError rozpoznaje ten typ w tym samym środowisku globalnym; obiekty z innego środowiska, np. innego okna, mogą nie przejść testu. Nie porównuj automatycznie generowanych komunikatów message, ponieważ ich treść może różnić się między silnikami.
Przykłady
try {
JSON.parse('{"count": }');
} catch (error) {
if (!(error instanceof SyntaxError)) {
throw error;
}
console.log(error.name);
}Wynik
SyntaxError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.