Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Promise.allSettled — wyniki wszystkich obietnic

Promise.allSettled przyjmuje obiekt iterowalny i zwraca obietnicę tablicy wyników wszystkich elementów. Zachowuje kolejność wejścia i zapisuje zarówno wartości spełnionych obietnic, jak i powody odrzucenia.

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.allSettled(iterable)

Promise.allSettled(iterable) to metoda statyczna dostępna od ECMAScript 2020, a nie osobne Web API. Przyjmuje synchroniczny obiekt iterowalny, np. tablicę, i przetwarza jego elementy zgodnie z Promise.resolve. Zwykłe wartości są więc również poprawnym wejściem. Dostępność w docelowej przeglądarce trzeba sprawdzić osobno; wersja Node używana w repozytorium jej nie dowodzi.

Zwrócona obietnica spełnia się tablicą po zakończeniu wszystkich elementów — przez spełnienie albo odrzucenie. Kolejność wyników odpowiada kolejności wejścia, nie kolejności zakończenia. Wynik ma postać { status: "fulfilled", value: ... } albo { status: "rejected", reason: ... }. Przed odczytem value lub reason sprawdź status.

W przeciwieństwie do Promise.all, odrzucenie pojedynczego elementu nie odrzuca zbiorczej obietnicy. Nie oznacza to jednak, że metoda nigdy jej nie odrzuca: błędne wejście, np. null, lub wyjątek podczas iteracji może spowodować odrzucenie. Jeśli iteracja zakończy się bez błędu, ale któryś element nigdy nie zostanie spełniony ani odrzucony, zbiorcza obietnica pozostanie w stanie oczekiwania.

Dla pustego wejścia zwracana obietnica jest już spełniona wartością [], ale funkcja przekazana do .then nadal wykona się asynchronicznie. Metoda nie anuluje operacji ani nie ogranicza współbieżności; zbiera ich wyniki.

Przykłady

const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];

Promise.allSettled(inputs).then((results) => {
  console.log(JSON.stringify(results));
});

Wynik

[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]

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

Źródła