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

Le constructeur AggregateError() permet de créer une erreur qui agrège plusieurs erreurs.

Syntaxe

new AggregateError(errors)
new AggregateError(errors, message)
new AggregateError(errors, message, options)

AggregateError(errors)
AggregateError(errors, message)
AggregateError(errors, message, options)

Note : La fonction AggregateError() peut être appelée avec ou sans new. Les deux créent une nouvelle instance d'AggregateError.

Paramètres

errors

Un objet itérable contenant les erreurs, qui peuvent ne pas être des instances de Error.

message Facultatif

Une description optionnelle, compréhensible par un·e humain·e, de l'erreur agrégée.

options Facultatif

Un objet qui possède les propriétés suivantes :

cause Facultatif: Une propriété indiquant la cause spécifique de l'erreur. Lors de la capture et de la relance d'une erreur avec un message plus précis ou plus utile, cette propriété permet de transmettre l'erreur d'origine.

Exemples

Créer une exception `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" ]
}