AggregateError

Baseline Large disponibilité

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.

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.

Comparé à SuppressedError, AggregateError représente une liste d'erreurs non liées, tandis que SuppressedError représente une erreur survenue lors de la gestion d'une autre erreur.

AggregateError est une sous-classe de Error.

Dans cet article

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.

js
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

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