Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Rekordy wyników Promise.allSettled()

Metoda `Promise.allSettled()` zwraca obietnicę, która po zakończeniu wszystkich obietnic wejściowych spełnia się tablicą wyników w kolejności wejścia. Pole `status` wskazuje, czy odczytać `value`, czy `reason`.

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

Składnia

Promise.allSettled(iterable)

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

Promise.allSettled(iterable) to statyczna metoda Promise, która przyjmuje synchroniczny obiekt iterowalny, na przykład tablicę. Każdy element jest przetwarzany jak przez Promise.resolve(): uwzględniane jest zachowanie obiektów typu thenable, a zwykła wartość staje się wartością spełnienia. Gdy wszystkie obietnice zostaną spełnione lub odrzucone, zwrócona obietnica spełnia się tablicą zawierającą po jednym wyniku na element, w kolejności iteracji, a nie zakończenia.

Każdy rekord wyniku to zwykły obiekt JavaScript. Rekord ze status: "fulfilled" ma własną właściwość value, ale nie ma własnej właściwości reason. Rekord ze status: "rejected" ma własną właściwość reason, ale nie ma własnej właściwości value. Najpierw sprawdź status: wartość 0 lub undefined może być prawidłową wartością spełnienia, a powód odrzucenia nie musi być obiektem Error i również może być undefined.

W przeciwieństwie do Promise.all() odrzucenie pojedynczej obietnicy jest zapisywane w tablicy i samo nie powoduje odrzucenia obietnicy zbiorczej. To przydatne, gdy chcesz zachować udane wyniki niezależnych zadań i osobno obsłużyć niepowodzenia. Błąd podczas odczytu obiektu iterowalnego nadal może odrzucić obietnicę zbiorczą, zamiast utworzyć rekord wyniku.

Dla pustego wejścia metoda zwraca obietnicę już spełnioną wartością [], ale funkcja przekazana do .then() nadal wykonuje się asynchronicznie. Dla niepustego wejścia, przy standardowym działaniu metod obietnic, obietnica zbiorcza pozostaje w stanie oczekiwania w chwili zwrotu, nawet jeśli żadna obietnica wejściowa już nie oczekuje. Obietnica zbiorcza może jednak być spełniona już w chwili zwrotu, jeśli jedynym elementem wejścia jest natywna obietnica, którą Promise.resolve() zwraca bez zmian i której własna metoda then synchronicznie wywołuje funkcję obsługującą spełnienie.

Przykłady

{
  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}`);
      }
    }
  });
}

Wynik

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

Druga obietnica zostaje odrzucona przed spełnieniem pierwszej, ale jej rekord nadal znajduje się na drugiej pozycji. Zwykła wartość `0` daje rekord ze statusem `"fulfilled"`.

Powiązane lekcje

  • JavaScript · Lekcja 15 · Średniozaawansowany · Wersja: 3

Źródła