WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen