Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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

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

Spécifications

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

Compatibilité des navigateurs

Voir