CKTIS / JavaScript
AggregateError: mehrere Fehler in einer Ausnahme
AggregateError bündelt Fehler einer Sammeloperation und bewahrt eine einzelne Fehlerliste sowie optional Nachricht und Ursache.
Version: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
new AggregateError(errors[, message[, options]])new AggregateError(errors, message, options) liest das iterierbare errors und speichert dessen Werte im Array errors. message ist optionaler Text, options.cause eine übergeordnete Ursache. Der Konstruktor liefert ein Fehlerobjekt; die enthaltenen Fehler werden nicht automatisch ausgelöst.
Verwende ihn, wenn eine Operation an mehreren unabhängigen Stellen scheitern kann, etwa bei Promise.any. Beim Abfangen wird normalerweise über error.errors iteriert. Ein nicht iterierbares erstes Argument löst TypeError aus; die Elemente müssen keine Error-Objekte sein.
Ein leeres Iterable ist gültig. Ohne message braucht die Instanz keine eigene message-Eigenschaft; cause entsteht nur bei Angabe. Das Beispiel kombiniert zwei Fehlerklassen und erhält die Sammelnachricht.
Beispiele
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);Ergebnis
AggregateError Import failed Error,TypeError batch-7