Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła