Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Promise.all — wspólny wynik wielu obietnic

Promise.all zwraca jedną obietnicę dla wszystkich elementów obiektu iterowalnego. Obietnica spełnia się tablicą wyników w kolejności wejściowej, jeśli iteracja kończy się bez błędu, a wszystkie elementy dają wynik. Pierwsze zaobserwowane odrzucenie obietnicy wejściowej powoduje odrzucenie wspólnej obietnicy. Może ją też odrzucić wyjątek zgłoszony podczas iteracji, nawet jeśli żadna z obietnic wejściowych nie zostanie odrzucona. Metoda nie anuluje pozostałych operacji.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

Promise.all(iterable)

Promise.all(iterable) to metoda statyczna przyjmująca synchroniczny obiekt iterowalny, na przykład tablicę. Zwraca nową obietnicę spełnianą tablicą wartości, gdy wszystkie elementy zakończą się sukcesem. Zwykłe wartości są akceptowane; obiekty z wywoływalną metodą then są przyswajane jak obietnice.

Kolejność wyników odpowiada kolejności elementów wejściowych, nie kolejności zakończenia operacji. Puste wejście daje obietnicę już spełnioną wartością []; funkcje przekazane do .then() nadal wykonują się asynchronicznie. Dla niepustego wejścia złożonego ze zwykłych wartości lub spełnionych obietnic spełnienie wyniku także jest asynchroniczne.

Pierwsze zaobserwowane odrzucenie odrzuca wspólną obietnicę z tą samą przyczyną, bez czekania na sukces pozostałych. Nie oznacza to anulowania ich pracy. Obsłuż odrzucenie przez .catch() albo try/catch wokół await. Metoda nie uruchamia przekazanych funkcji: aby zebrać wyniki ich pracy, wywołaj je i przekaż zwrócone obietnice.

W przykładzie first spełnia się po second, lecz wynik zachowuje kolejność wejściową. Liczba 3 trafia do tablicy bez zmian, a sync pojawia się przed wynikiem.

Przykłady

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");

Wynik

sync
["A","B",3]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła