CKTIS / JavaScript
AggregateError : plusieurs échecs dans une exception
AggregateError regroupe les échecs d’une opération collective tout en gardant la liste des erreurs, un message et une cause facultatifs.
Version : ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
new AggregateError(errors[, message[, options]])new AggregateError(errors, message, options) consomme l’itérable errors et place ses valeurs dans le tableau errors. message est facultatif et options.cause indique une cause de niveau supérieur. La construction renvoie un objet erreur sans relancer automatiquement les erreurs contenues.
Utilise-le lorsqu’une opération peut échouer indépendamment à plusieurs endroits, comme Promise.any. Le traitement parcourt généralement error.errors. Un premier argument non itérable lève TypeError ; ses éléments ne sont pas obligatoirement des objets Error.
Un itérable vide est valide. Sans message, l’instance peut ne pas posséder cette propriété ; cause n’existe que si elle est fournie. L’exemple réunit deux classes d’erreur sans perdre le message global.
Exemples
const failures = [new Error("disk"), new TypeError("format")];
const error = new AggregateError(failures, "Import failed", {cause: "batch-7"});
console.log(error.name);
console.log(error.message);
console.log(error.errors.map(item => item.name).join(","));
console.log(error.cause);Résultat
AggregateError Import failed Error,TypeError batch-7