CKTIS / JavaScript
Promise.race — pierwsze rozstrzygnięcie
Promise.race(iterable) zwraca obietnicę, która przejmuje wartość spełnienia lub powód odrzucenia z pierwszego obsłużonego rozstrzygnięcia. Nie czeka na pierwszy sukces i 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.race(iterable)Promise.race(iterable) to statyczna metoda przyjmująca synchroniczny obiekt iterowalny, np. tablicę. Każdy element jest przetwarzany przez Promise.resolve: może być obietnicą, obiektem z metodą then lub zwykłą wartością.
Wynik przejmuje pierwsze obsłużone spełnienie lub odrzucenie. Odrzucenie może więc wygrać z sukcesem. Jeśli wejście zawiera wyłącznie zwykłe wartości bez wywoływalnej metody then lub już rozstrzygnięte natywne obietnice, które Promise.resolve zwraca bez zmian, o wyniku decyduje kolejność iteracji. Jeśli jednak Promise.resolve utworzy nową obietnicę dla już rozstrzygniętej natywnej obietnicy z innego środowiska wykonawczego (realmu ECMAScript), przejęcie jej stanu wymaga dodatkowych kroków asynchronicznych. Zwykła wartość lub już rozstrzygnięta obietnica z tego samego realmu może wtedy wygrać, nawet jeśli pojawi się później w iteracji. Funkcje obsługujące wynik nadal wykonują się asynchronicznie.
Promise.race([]) pozostaje w stanie oczekiwania bez końca. Błąd podczas pobierania iteratora lub iteracji powoduje odrzucenie wyniku. Metoda nie anuluje przegranych operacji: ich zatrzymanie wymaga osobnego mechanizmu.
W przykładzie pending nigdy się nie rozstrzyga. Spośród pozostałych obietnic, zwracanych przez Promise.resolve bez zmian, odrzucona występuje przed spełnioną, więc wynik to rejected: failed. Wcześniej pojawia się sync, ponieważ funkcja przekazana do then nie wykonuje się w bieżącym stosie wywołań.
Przykłady
const pending = new Promise(() => {});
const result = Promise.race([
pending,
Promise.reject("failed"),
Promise.resolve("ready")
]);
result.then(
value => console.log("fulfilled: " + value),
reason => console.log("rejected: " + reason)
);
console.log("sync");Wynik
sync rejected: failed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.