Constructeur SyntaxError()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Le constructeur SyntaxError() permet de créer un objet représentant une erreur qui se produit lorsqu'on essaie d'interpréter du code dont la syntaxe est invalide.

Syntaxe

js
new SyntaxError();
new SyntaxError(message);
new SyntaxError(message, nomFichier);
new SyntaxError(message, nomFichier, numeroLigne);

Paramètres

message Facultatif

Une description de l'erreur, compréhensible par un humain.

nomFichier Facultatif

Le nom du fichier contenant le code qui a déclenché l'exception.

numeroLigne Facultatif

Le numéro de la ligne du code qui a déclenché l'exception.

Exemples

Intercepter une exception SyntaxError

js
try {
  eval("coucou truc");
} catch (e) {
  console.error(e instanceof SyntaxError);
  console.error(e.message);
  console.error(e.name);
  console.error(e.fileName);
  console.error(e.lineNumber);
  console.error(e.columnNumber);
  console.error(e.stack);
}

Créer une exception SyntaxError

js
try {
  throw new SyntaxError("Coucou", "unFichier.js", 10);
} catch (e) {
  console.error(e instanceof SyntaxError); // true
  console.error(e.message); // Coucou
  console.error(e.name); // SyntaxError
  console.error(e.fileName); // unFichier.js
  console.error(e.lineNumber); // 10
  console.error(e.columnNumber); // 0
  console.error(e.stack); // @debugger eval code:3:9
}

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-nativeerror-constructors

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi