Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

SyntaxError — erros de sintaxe

SyntaxError indica uma falha de análise em código ou texto que tem de seguir uma sintaxe específica, como JSON. Saiba distinguir um erro que impede a execução de um script de uma exceção lançada durante a execução.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new SyntaxError(message)
SyntaxError(message)
throw new SyntaxError(message)

SyntaxError é um tipo de erro ECMAScript integrado que herda de Error. Assinala um problema de análise; não é uma Web API separada. Por exemplo, código JavaScript inválido pode ser rejeitado antes da execução, enquanto JSON.parse() lança esta exceção quando o texto JSON é inválido.

new SyntaxError(message) cria um objeto, mas não o lança; para isso, utilize throw. O parâmetro message é opcional. A chamada SyntaxError(message) sem new também cria um objeto de erro. O valor predefinido de name é "SyntaxError", e message descreve o problema.

Um bloco try...catch não consegue capturar um erro de sintaxe que impeça a análise do mesmo script: esse script nunca chega a começar a ser executado. No entanto, pode capturar um SyntaxError lançado durante a execução, como o que JSON.parse() lança ao analisar texto fornecido como argumento.

No exemplo, falta um valor JSON depois de "count":. O próprio código JavaScript continua válido, pelo que catch pode tratar a exceção. O teste instanceof SyntaxError reconhece este tipo no mesmo realm; objetos de outro realm, como outra janela, podem não passar no teste. Não compare as cadeias message geradas automaticamente, pois a sua redação pode variar entre motores.

Exemplos

try {
  JSON.parse('{"count": }');
} catch (error) {
  if (!(error instanceof SyntaxError)) {
    throw error;
  }
  console.log(error.name);
}

Resultado

SyntaxError

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes