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