AggregateError

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.

* Some parts of this feature may have varying levels of support.

Das AggregateError-Objekt stellt einen Fehler dar, wenn mehrere Fehler in einem einzigen Fehler zusammengefasst werden müssen. Es wird ausgelöst, wenn mehrere Fehler von einer Operation gemeldet werden müssen, zum Beispiel durch Promise.any(), wenn alle an sie übergebenen Versprechen abgelehnt werden.

Im Vergleich zu SuppressedError repräsentiert AggregateError eine Liste von nicht zusammenhängenden Fehlern, während SuppressedError einen Fehler darstellt, der während der Behandlung eines anderen Fehlers auftrat.

AggregateError ist eine Unterklasse von Error.

Konstruktor

AggregateError(): Erstellt ein neues AggregateError-Objekt.

Instanz-Eigenschaften

Erbt auch Instanz-Eigenschaften von seinem übergeordneten Error.

Diese Eigenschaften sind auf AggregateError.prototype definiert und werden von allen AggregateError-Instanzen geteilt.

AggregateError.prototype.constructor: Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für AggregateError-Instanzen ist der Anfangswert der AggregateError-Konstruktor.
AggregateError.prototype.name: Repräsentiert den Namen des Fehlertyps. Für AggregateError.prototype.name ist der Anfangswert "AggregateError".

Diese Eigenschaften sind eigenständige Eigenschaften jeder AggregateError-Instanz.

errors: Ein Array, das die aggregierten Fehler darstellt.

Promise.any([Promise.reject(new Error("some error"))]).catch((e) => {
  console.log(e instanceof AggregateError); // true
  console.log(e.message); // "All Promises rejected"
  console.log(e.name); // "AggregateError"
  console.log(e.errors); // [ Error: "some error" ]
});

Erstellen eines AggregateError

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" ]
}