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.

Un objet AggregateError représente une erreur lorsque plusieurs erreurs doivent être agrégées en une seule. Ce type d'exception est levée lorsque plusieurs erreurs sont rapportées par une opération, par exemple avec Promise.any() lorsque l'ensemble des promesses qui lui sont passées échouent.

Constructeur

AggregateError(): Crée un nouvel objet AggregateError.

Propriétés des instances

AggregateError.prototype.message: Le message d'erreur. La valeur par défaut est "".
AggregateError.prototype.name: Le nom de l'erreur. La valeur par défaut est "AggregateError".

Exemples

Intercepter une erreur `AggregateError`

Promise.any([Promise.reject(new Error("une erreur"))]).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: "une erreur" ]
});

Créer un objet `AggregateError`

try {
  throw new AggregateError([new Error("une erreur")], "Coucou");
} catch (e) {
  console.log(e instanceof AggregateError); // true
  console.log(e.message); // "Coucou"
  console.log(e.name); // "AggregateError"
  console.log(e.errors); // [ Error: "une erreur" ]
}

Spécifications

Specification
ECMAScript Language Specification # sec-aggregate-error-objects

Compatibilité des navigateurs

BCD tables only load in the browser

Voir

Error