CKTIS / JavaScript
Promise.race — první splnění nebo zamítnutí
Promise.race(iterable) vrací promise, která převezme hodnotu splnění nebo důvod zamítnutí podle toho, který výsledek se zpracuje jako první. Nečeká na první úspěch a ostatní operace nezruší.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.race(iterable)Promise.race(iterable) je statická metoda, která přijímá synchronní iterovatelný objekt, například pole. Každý prvek se zpracuje pomocí Promise.resolve: může jít o promise, objekt s metodou then nebo běžnou hodnotu.
Výsledek převezme první zpracované splnění nebo zamítnutí. Zamítnutí tedy může předběhnout úspěch. Pokud jsou všechny prvky běžné hodnoty bez volatelné metody then nebo již splněné či zamítnuté nativní promise, které Promise.resolve vrací beze změny, o vítězi rozhoduje pořadí iterace. Metoda Promise.resolve však může již splněnou nebo zamítnutou nativní promise z jiného prostředí ECMAScriptu (realmu) obalit novou promise. Převzetí jejího stavu pak vyžaduje další asynchronní kroky. Běžná hodnota nebo již splněná či zamítnutá promise ze stejného realmu tak může vyhrát, i když se při iteraci objeví později. Obslužné funkce výsledku se nadále spouštějí asynchronně.
Promise.race([]) zůstane navždy ve stavu čekání. Chyba při získávání iterátoru nebo během iterace způsobí zamítnutí výsledku. Metoda nezruší prohrávající operace: k jejich zastavení je potřeba samostatný mechanismus.
V příkladu pending nikdy neopustí stav čekání. Obě zbývající promise vrátí Promise.resolve beze změny. Zamítnutá je před splněnou, takže výsledkem je rejected: failed. Řádek sync se objeví dříve, protože obslužná funkce předaná do then se nespouští v aktuálním zásobníku volání.
Pří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ýsledek
sync rejected: failed
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.