CKTIS / JavaScript
Promise.race — première réalisation ou premier rejet
Promise.race(iterable) renvoie une promesse qui adopte la valeur de réalisation ou la raison de rejet du premier dénouement traité. Elle n’attend pas le premier succès et 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.race(iterable)Promise.race(iterable) est une méthode statique qui accepte un itérable synchrone, comme un tableau. Chaque élément est traité avec Promise.resolve : il peut s’agir d’une promesse, d’un objet doté d’une méthode then ou d’une valeur ordinaire.
Le résultat adopte la première réalisation ou le premier rejet traité. Un rejet peut donc l’emporter sur un succès. Si les éléments sont tous des valeurs ordinaires sans méthode then appelable ou des promesses natives déjà réalisées ou rejetées que Promise.resolve renvoie telles quelles, l’ordre d’itération détermine le gagnant. Cependant, Promise.resolve peut envelopper une promesse native déjà réalisée ou rejetée provenant d’un autre environnement ECMAScript (realm) dans une nouvelle promesse, ce qui ajoute des étapes asynchrones pour en adopter l’état. Une valeur ordinaire ou une promesse déjà réalisée ou rejetée du même environnement peut alors l’emporter même si elle apparaît plus tard dans l’itération. Les gestionnaires du résultat s’exécutent toujours de façon asynchrone.
Promise.race([]) reste en attente indéfiniment. Une erreur lors de l’obtention de l’itérateur ou pendant l’itération entraîne le rejet du résultat. La méthode n’annule pas les opérations perdantes : leur arrêt nécessite un mécanisme distinct.
Dans l’exemple, pending reste indéfiniment en attente. Promise.resolve renvoie les deux autres promesses telles quelles. La promesse rejetée précède la promesse réalisée : le résultat est donc rejected: failed. La ligne sync apparaît avant, car le gestionnaire transmis à then ne s’exécute pas dans la pile d’appels actuelle.
Exemples
const pending = new Promise(() => {});
const result = Promise.race([
pending,
Promise.reject("failed"),
Promise.resolve("ready")
]);
result.then(
value => console.log("fulfilled: " + value),
reason => console.log("rejected: " + reason)
);
console.log("sync");Résultat
sync rejected: failed
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.