CKTIS / JavaScript
SyntaxError — erreurs de syntaxe
SyntaxError signale un échec d’analyse dans du code ou un texte qui doit respecter une syntaxe particulière, comme JSON. Découvrez la différence entre une erreur qui empêche un script de s’exécuter et une exception déclenchée pendant son exécution.
Version : 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 est un type d’erreur ECMAScript intégré qui hérite de Error. Il signale un problème d’analyse ; ce n’est pas une API Web distincte. Par exemple, du code JavaScript invalide peut être rejeté avant son exécution, tandis que JSON.parse() déclenche cette exception pour un texte JSON invalide.
new SyntaxError(message) crée un objet, mais ne le déclenche pas ; pour cela, utilisez throw. Le paramètre message est facultatif. Appeler SyntaxError(message) sans new crée également un objet d’erreur. La valeur par défaut de name est "SyntaxError", et message décrit le problème.
Un bloc try...catch ne peut pas intercepter une erreur de syntaxe qui empêche l’analyse du même script : ce script ne commence alors jamais à s’exécuter. Il peut toutefois intercepter un SyntaxError déclenché pendant l’exécution, par exemple par JSON.parse() lors de l’analyse d’un texte fourni en argument.
Dans l’exemple, une valeur JSON manque après "count":. Le code JavaScript lui-même reste valide, donc catch peut traiter l’exception. Le test instanceof SyntaxError reconnaît ce type dans le même realm ; les objets provenant d’un autre realm, comme une autre fenêtre, peuvent ne pas réussir le test. Ne comparez pas les chaînes message générées automatiquement, car leur formulation peut varier selon les moteurs.
Exemples
try {
JSON.parse('{"count": }');
} catch (error) {
if (!(error instanceof SyntaxError)) {
throw error;
}
console.log(error.name);
}Résultat
SyntaxError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.