CKTIS / JavaScript
Promise.all — un résultat commun à plusieurs promesses
Promise.all renvoie une seule promesse pour tous les éléments d’un objet itérable. Si l’itération se termine sans erreur et que tous les éléments fournissent une valeur, la promesse est tenue avec un tableau de résultats dans l’ordre d’entrée. Le premier rejet observé parmi les promesses d’entrée entraîne le rejet de la promesse commune. Une exception levée pendant l’itération peut aussi entraîner son rejet, même si aucune promesse d’entrée n’est rejetée. La méthode n’annule pas les autres opérations.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.all(iterable)Promise.all(iterable) est une méthode statique qui accepte un objet itérable synchrone, comme un tableau. Elle renvoie une nouvelle promesse, tenue avec un tableau de valeurs lorsque tous les éléments réussissent. Les valeurs ordinaires sont acceptées ; les objets dotés d’une méthode then appelable sont assimilés à des promesses.
L’ordre des résultats suit celui des éléments d’entrée, et non celui de la fin des opérations. Une entrée vide produit une promesse déjà tenue avec [] ; les fonctions de rappel passées à .then() s’exécutent néanmoins de manière asynchrone. Pour une entrée non vide composée de valeurs ordinaires ou de promesses tenues, la résolution du résultat est également asynchrone.
Le premier rejet observé rejette la promesse combinée avec la même raison, sans attendre la réussite des autres. Cela n’annule pas leur travail. Gérez les rejets avec .catch() ou avec try/catch autour de await. La méthode n’appelle pas les fonctions fournies : pour recueillir leurs résultats, appelez-les et transmettez les promesses renvoyées.
Dans l’exemple, first est tenue après second, mais le résultat conserve l’ordre d’entrée. Le nombre 3 apparaît sans changement dans le tableau, et sync est affiché avant le résultat.
Exemples
const first = Promise.resolve().then(() => "A");
const second = Promise.resolve("B");
Promise.all([first, second, 3]).then((values) => {
console.log(JSON.stringify(values));
});
console.log("sync");Résultat
sync ["A","B",3]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.