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 einzelnen Fehler zusammengefasst werden müssen. Es wird ausgelöst, wenn mehrere Fehler bei einer Operation gemeldet werden müssen, zum Beispiel durch Promise.any(), wenn alle übergebenen Promise-Objekte abgelehnt werden.

AggregateError ist eine Unterklasse von Error.

Konstruktor

AggregateError()

Erstellt ein neues AggregateError-Objekt.

Instanz-Eigenschaften

Erbt auch Instanz-Eigenschaften von seinem Elternteil 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. Bei AggregateError-Instanzen ist der Anfangswert der AggregateError-Konstruktor.

AggregateError.prototype.name

Repräsentiert den Namen für die Art des Fehlers. Bei AggregateError.prototype.name ist der Anfangswert "AggregateError".

Diese Eigenschaften sind die eigenen Eigenschaften jeder AggregateError-Instanz.

errors

Ein Array, das die aggregierten Fehler repräsentiert.

Instanz-Methoden

Erbt Instanz-Methoden von seinem Elternteil Error.

Beispiele

Abfangen eines AggregateError

js
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

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-objects

Browser-Kompatibilität

Siehe auch