Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje