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.