Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

AggregateError()-Konstruktor

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⁩.

Der AggregateError()-Konstruktor erzeugt AggregateError-Objekte.

Syntax

js
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.

message Optional

Eine optionale, menschenlesbare Beschreibung des Aggregatfehlers.

options Optional

Ein Objekt mit den folgenden Eigenschaften:

cause Optional

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

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

Browser-Kompatibilität

Siehe auch