Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes