CKTIS / JavaScript
AggregateError: varios fallos en una excepción
AggregateError agrupa fallos de una operación colectiva y conserva la lista de errores, el mensaje y la causa opcionales.
Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxis
new AggregateError(errors[, message[, options]])new AggregateError(errors, message, options) consume el iterable errors y guarda sus valores en el array errors. message es opcional y options.cause registra una causa superior. El constructor devuelve un objeto de error; no lanza automáticamente los errores contenidos.
Úsalo cuando una operación pueda fallar de forma independiente en varios puntos, como Promise.any. Al capturarlo suele recorrerse error.errors. Un primer argumento no iterable lanza TypeError; los elementos no tienen que ser objetos Error.
Un iterable vacío es válido. Si se omite message, la instancia puede no tener esa propiedad propia; cause solo se crea cuando se proporciona. El ejemplo combina dos clases de error y conserva el mensaje global.
Ejemplos
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