AggregateError()-Konstruktor
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.
Der AggregateError()-Konstruktor erzeugt AggregateError-Objekte.
Syntax
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 Aufrufarten erzeugen eine neue AggregateError-Instanz.
Parameter
errors-
Ein Iterable von Fehlern, die möglicherweise keine
Error-Instanzen sind. messageOptional-
Eine optionale, menschenlesbare Beschreibung des Aggregatfehlers.
optionsOptional-
Ein Objekt mit den folgenden Eigenschaften:
causeOptional-
Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Diese Eigenschaft kann verwendet werden, um den ursprünglichen Fehler zu übergeben, wenn ein Fehler abgefangen und mit einer spezifischeren oder nützlicheren Fehlermeldung erneut ausgelöst wird.
Beispiele
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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-aggregate-error-constructor |