Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła