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.

Das AggregateError-Objekt repräsentiert einen Fehler, 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 Promises abgelehnt werden.

AggregateError ist eine Unterklasse von Error.

Konstruktor

AggregateError()

Erzeugt 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 für den Fehlertyp. Für AggregateError.prototype.name ist der Anfangswert "AggregateError".

Diese Eigenschaften sind eigene Eigenschaften jeder AggregateError-Instanz.

errors

Ein Array, das die aggregierten Fehler darstellt.

Instanz-Methoden

Erbt Instanz-Methoden von seinem übergeordneten 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 Language Specification
# sec-aggregate-error-objects

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch