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 derAggregateError
-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
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" ]
}
Spezifikationen
Specification |
---|
ECMAScript Language Specification # sec-aggregate-error-objects |
Browser-Kompatibilität
BCD tables only load in the browser