AggregateError

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨septembre 2020⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

Un objet AggregateError représente une erreur lorsque plusieurs erreurs doivent être agrégées en une seule. Ce type d'exception est levé 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.

AggregateError est une sous-classe de Error.

Constructeur

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

Propriétés d'instances

Hérite également des propriétés d'instance de son parent Error.

Ces propriétés sont définies sur AggregateError.prototype et sont partagées par toutes les instances d'AggregateError.

AggregateError.prototype.constructor: La fonction constructeur qui a créé l'instance de l'objet. Pour les instances d'AggregateError, la valeur initiale est le constructeur AggregateError.
AggregateError.prototype.name: Représente le nom du type d'erreur. Pour AggregateError.prototype.name, la valeur initiale est "AggregateError".

Ces propriétés sont des propriétés propres à chaque instance d'AggregateError.

errors: Un tableau représentant les erreurs qui ont été agrégées.

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" ]
}