CKTIS / JavaScript
AggregateError: várias falhas numa exceção
AggregateError agrupa falhas de uma operação coletiva, mantendo a lista de erros e mensagem e causa opcionais.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
new AggregateError(errors[, message[, options]])new AggregateError(errors, message, options) consome o iterável errors e guarda os valores no array errors. message é opcional e options.cause regista uma causa superior. O construtor devolve um objeto de erro; não lança automaticamente os erros contidos.
Usa-o quando uma operação possa falhar independentemente em vários pontos, como Promise.any. Ao capturá-lo, percorre normalmente error.errors. Um primeiro argumento não iterável lança TypeError; os elementos não têm de ser objetos Error.
Um iterável vazio é válido. Sem message, a instância pode não ter essa propriedade própria; cause só é criada quando fornecida. O exemplo combina duas classes de erro sem perder a mensagem global.
Exemplos
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);Resultado
AggregateError Import failed Error,TypeError batch-7