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

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

Sources