Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes