CKTIS / JavaScript
AggregateError: více selhání v jedné výjimce
AggregateError seskupuje selhání hromadné operace a zachovává seznam chyb i volitelnou zprávu a příčinu.
Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
new AggregateError(errors[, message[, options]])new AggregateError(errors, message, options) spotřebuje iterovatelný objekt errors a uloží hodnoty do pole errors. message je volitelný text a options.cause zaznamená nadřazenou příčinu. Konstruktor vrací objekt chyby; obsažené chyby automaticky nevyhazuje.
Použij jej, když může jedna operace selhat na více nezávislých místech, například Promise.any. Obsluha obvykle prochází error.errors. Neiterovatelný první argument vyvolá TypeError; prvky nemusí být objekty Error.
Prázdný iterovatelný objekt je platný. Bez message nemusí mít instance vlastní stejnojmennou vlastnost; cause vznikne jen při zadání. Příklad spojuje dvě třídy chyb a zachovává společnou zprávu.
Příklady
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);Výsledek
AggregateError Import failed Error,TypeError batch-7