AggregateError() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Der AggregateError() Konstruktor erstellt AggregateError Objekte.

Syntax

js
new AggregateError(errors)
new AggregateError(errors, message)
new AggregateError(errors, message, options)

AggregateError(errors)
AggregateError(errors, message)
AggregateError(errors, message, options)

Hinweis: AggregateError() kann mit oder ohne new aufgerufen werden. Beide erzeugen eine neue AggregateError Instanz.

Parameter

errors

Ein iterierbares Objekt von Fehlern, die möglicherweise nicht wirklich Error Instanzen sind.

message Optional

Eine optionale, für Menschen lesbare Beschreibung des aggregierten Fehlers.

options Optional

Ein Objekt mit folgenden Eigenschaften:

cause Optional

Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Beim Abfangen und erneuten Auslösen eines Fehlers mit einer spezifischeren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übergeben.

Beispiele

Erstellen eines AggregateError

js
try {
  throw new AggregateError([new Error("some error")], "Hello");
} catch (e) {
  console.log(e instanceof AggregateError); // true
  console.log(e.message); // "Hello"
  console.log(e.name); // "AggregateError"
  console.log(e.errors); // [ Error: "some error" ]
}

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-aggregate-error-constructor

Browser-Kompatibilität

Siehe auch