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 erstellt 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 erzeugen eine neue AggregateError Instanz.
Parameter
errors-
Ein iterierbares Objekt von Fehlern, die möglicherweise keine
ErrorInstanzen sind. messageOptional-
Eine optionale, für Menschen lesbare Beschreibung des Sammelfehlers.
optionsOptional-
Ein Objekt, das die folgenden Eigenschaften hat:
causeOptional-
Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Beim Abfangen und erneuten Auslösen eines Fehlers mit einer genaueren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übermitteln.
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 |