Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Objets de résultat de Promise.allSettled()

`Promise.allSettled()` renvoie une promesse qui, une fois toutes les promesses d’entrée réglées, est tenue avec un tableau de résultats dans l’ordre d’entrée. `status` indique s’il faut lire `value` ou `reason`.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

Promise.allSettled(iterable)

// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }

Promise.allSettled(iterable) est une méthode statique de Promise qui accepte un itérable synchrone, comme un tableau. Elle traite chaque élément comme le ferait Promise.resolve() : elle adopte l’issue des objets thenables et utilise les valeurs simples comme valeurs d’accomplissement. Une fois toutes les promesses d’entrée tenues ou rejetées, la promesse renvoyée est tenue avec un tableau contenant un résultat par élément, dans l’ordre d’itération et non dans l’ordre d’achèvement.

Chaque résultat est un objet JavaScript ordinaire. Avec status: "fulfilled", l’objet possède une propriété propre value, mais pas de propriété propre reason. Avec status: "rejected", il possède une propriété propre reason, mais pas de propriété propre value. Vérifie d’abord status : 0 et undefined sont des valeurs d’accomplissement valides. Le motif de rejet n’est pas forcément un Error et peut aussi être undefined.

Contrairement à Promise.all(), un rejet individuel est consigné dans le tableau et ne rejette pas à lui seul la promesse globale. C’est utile pour conserver les résultats des tâches indépendantes qui ont réussi et traiter les échecs séparément. En revanche, une erreur de lecture de l’itérable peut rejeter la promesse globale au lieu de produire un objet de résultat.

Si l’itérable est vide, la méthode renvoie une promesse déjà tenue avec [], mais une fonction passée à .then() s’exécute quand même de manière asynchrone. Si l’itérable n’est pas vide, avec le comportement standard des promesses, la promesse globale est encore en attente quand la méthode la renvoie, même si aucune promesse d’entrée n’est encore en attente. Elle peut toutefois être déjà tenue à ce moment-là si l’unique élément est une promesse native que Promise.resolve() renvoie sans modification et dont la méthode propre then appelle de façon synchrone la fonction prévue en cas d’accomplissement.

Exemples

{
  let finishFirst;
  const first = new Promise((resolve) => { finishFirst = resolve; });
  const second = Promise.reject("offline");
  const batch = Promise.allSettled([first, second, 0]);
  finishFirst("profile");

  batch.then((results) => {
    console.log(JSON.stringify(results));
    for (const result of results) {
      if (result.status === "fulfilled") {
        console.log(`value: ${result.value}`);
      } else {
        console.log(`reason: ${result.reason}`);
      }
    }
  });
}

Résultat

[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0

La deuxième promesse est rejetée avant que la première soit tenue, mais son objet de résultat reste en deuxième position. La valeur simple `0` produit un objet de statut `"fulfilled"`.

Leçons associées

  • JavaScript · Leçon 15 · Intermédiaire · Version : 3

Sources