Promise.allSettled()

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 ⁨juillet 2020⁩.

La méthodePromise.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.

Exemple interactif

const promise1 = Promise.resolve(3);const promise2 = new Promise((resolve, reject) =>  setTimeout(reject, 100, "foo"),);const promises = [promise1, promise2];Promise.allSettled(promises).then((results) =>  results.forEach((result) => console.log(result.status)),);// Expected output:// "fulfilled"// "rejected"

Syntaxe

p.allSettled(iterable);

Paramètres

iterable: Un objetité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çonasynchrone 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. Sistatus vautfulfilled, alors on aura une propriétévalue. Sistatus vautrejected, alors une propriétéreason sera présente. La valeur (ou la raison) reflète la valeur de résolution de la promesse.