CKTIS / JavaScript
Promise.race — prvé splnenie alebo zamietnutie
Promise.race(iterable) vracia promise, ktorá prevezme hodnotu splnenia alebo dôvod zamietnutia podľa toho, ktorý výsledok sa spracuje ako prvý. Nečaká na prvý úspech a ostatné operácie nezruší.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Promise.race(iterable)Promise.race(iterable) je statická metóda, ktorá prijíma synchrónny iterovateľný objekt, napríklad pole. Každý prvok sa spracuje pomocou Promise.resolve: môže ísť o promise, objekt s metódou then alebo bežnú hodnotu.
Výsledok prevezme prvé spracované splnenie alebo zamietnutie. Zamietnutie teda môže predbehnúť úspech. Ak sú všetky prvky bežné hodnoty bez volateľnej metódy then alebo už splnené či zamietnuté natívne promise, ktoré Promise.resolve vráti bez zmeny, o víťazovi rozhoduje poradie iterácie. Metóda Promise.resolve však môže už splnenú alebo zamietnutú natívnu promise z iného prostredia ECMAScriptu (realmu) obaliť novou promise. Prevzatie jej stavu si potom vyžaduje ďalšie asynchrónne kroky. Bežná hodnota alebo už splnená či zamietnutá promise z toho istého realmu tak môže vyhrať, aj keď sa pri iterácii objaví neskôr. Obslužné funkcie výsledku sa naďalej spúšťajú asynchrónne.
Promise.race([]) zostane navždy v stave čakania. Chyba pri získavaní iterátora alebo počas iterácie spôsobí zamietnutie výsledku. Metóda nezruší prehrávajúce operácie: na ich zastavenie je potrebný samostatný mechanizmus.
V príklade pending nikdy neopustí stav čakania. Obe zvyšné promise vráti Promise.resolve bez zmeny. Zamietnutá je pred splnenou, takže výsledkom je rejected: failed. Riadok sync sa zobrazí skôr, pretože obslužná funkcia odovzdaná do then sa nevykonáva v aktuálnom zásobníku volaní.
Príklady
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");Výsledok
sync rejected: failed
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.