Promise.allSettled()

La méthode Promise.allSettled() renvoie une promesse qui est résolue une fois que l'ensemble des promesses de l'itérable passée en argument sont réussies ou rejetées. La valeur de résolution de cette promesse est un tableau d'objets dont chacun est le résultat de chaque promesse de l'itérable.

Syntaxe

p.allSettled(iterable);

Paramètres

iterable
Un objet itérable tel qu'un tableau (Array) dont chaque élément est une promesse (Promise.

Valeur de retour

Une promesse (Promise) en cours qui sera résolue de façon asynchrone une fois que chaque promesse de l'itérable a été résolue (tenue/réussie ou rejetée/échouée). Le gestionnaire passé à la promesse retournée recevra comme argument un tableau de valeur dont chacune est le résultat de chaque promesse de l'itérable initial.

Pour chaque objet contenu dans ce tableau, il y aura une propriété status qui est une chaîne de caractères. Si status vaut fulfilled, alors on aura une propriété value. Si status vaut rejected, alors une propriété reason sera présente. La valeur (ou la raison) reflète la valeur de résolution de la promesse.

Spécifications

Spécification État Commentaires
Promise.allSettled() (Brouillon TC39 au niveau 4) Standard évolutif

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi