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.