CKTIS / JavaScript
Promise.race — prvo ispunjenje ili odbijanje
Promise.race(iterable) vraća obećanje koje preuzima vrijednost ispunjenja ili razlog odbijanja, ovisno o tome koji se ishod prvi obradi. Ne čeka na prvi uspjeh i ne otkazuje preostale operacije.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Promise.race(iterable)Promise.race(iterable) statička je metoda koja prihvaća sinkroni iterabilni objekt, primjerice polje. Svaki se element obrađuje pomoću Promise.resolve: može biti obećanje, objekt s metodom then ili obična vrijednost.
Rezultat preuzima prvo obrađeno ispunjenje ili odbijanje. Odbijanje stoga može preteći ispunjenje. Ako su svi elementi obične vrijednosti bez pozivljive metode then ili već ispunjena ili odbijena nativna obećanja koja Promise.resolve vraća nepromijenjena, redoslijed iteracije određuje pobjednika. Međutim, Promise.resolve može omotati već ispunjeno ili odbijeno nativno obećanje iz drugog okruženja ECMAScripta (realm) novim obećanjem. Za preuzimanje njegova stanja tada su potrebni dodatni asinkroni koraci. Obična vrijednost ili već ispunjeno ili odbijeno obećanje iz istog okruženja tako može pobijediti čak i ako se u iteraciji pojavi kasnije. Obrađivači rezultata i dalje se izvršavaju asinkrono.
Promise.race([]) zauvijek ostaje na čekanju. Pogreška pri dohvaćanju iteratora ili tijekom iteracije uzrokuje odbijanje rezultata. Metoda ne otkazuje operacije koje nisu pobijedile: za njihovo zaustavljanje potreban je zaseban mehanizam.
U primjeru pending zauvijek ostaje na čekanju. Promise.resolve vraća druga dva obećanja nepromijenjena. Odbijeno je prije ispunjenog pa je rezultat rejected: failed. Redak sync pojavljuje se ranije jer se obrađivač proslijeđen metodi then ne izvršava u trenutačnom stogu poziva.
Primjeri
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");Rezultat
sync rejected: failed
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.