Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Error : objet d’exception de base

Error crée l’objet d’erreur de base avec message et cause facultatifs, destiné à lever et chaîner des échecs.

Version : ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2

Syntaxe

Error(message?, options?); new Error(message?, options?)

new Error(message?, options?) crée un objet d’erreur ; appeler Error(...) sans new a le même effet. Si message n’est pas undefined, il est converti en chaîne et stocké comme propriété propre message, non énumérable. La propriété héritée name vaut "Error" par défaut.

Si options est un objet possédant cause, sa valeur est copiée sans conversion dans une propriété propre cause, non énumérable. Cela conserve l’exception d’origine tout en ajoutant du contexte. La conversion du message ou le getter cause peut lever. Error peut être sous-classé et instanceof Error reconnaît les instances ordinaires.

stack est une extension d’hôte utile mais non standard, au format non portable. Pour des catégories propres, utilisez des sous-classes plutôt que d’analyser message. Error existe depuis ECMAScript 1 ; l’option cause est standard depuis ECMAScript 2022.

Exemples

function loadConfig() {
  try {
    JSON.parse("{");
  } catch (cause) {
    throw new Error("Could not load config", {cause});
  }
}

try {
  loadConfig();
} catch (error) {
  console.log(error.name, error.message);
  console.log(error.cause instanceof SyntaxError);
  console.log(Object.keys(error).join(",") || "(none)");
}
console.log(Error("plain") instanceof Error);

Résultat

Error Could not load config
true
(none)
true

Sources