CKTIS / JavaScript
Promise.race — eerste afwikkeling
Promise.race(iterable) retourneert een promise die de waarde bij vervulling of de reden voor afwijzing van de eerst verwerkte afwikkeling overneemt. De methode wacht niet op het eerste succes en annuleert de overige bewerkingen niet.
Versie: 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) is een statische methode die een synchrone iterable accepteert, zoals een array. Elk element wordt verwerkt via Promise.resolve: het kan een promise zijn, een object met een then-methode of een gewone waarde.
Het resultaat neemt de eerste verwerkte vervulling of afwijzing over. Een afwijzing kan dus winnen van een succes. Als alle elementen gewone waarden zonder aanroepbare then-methode zijn of al vervulde of afgewezen native promises die Promise.resolve ongewijzigd teruggeeft, bepaalt de iteratievolgorde de winnaar. Promise.resolve kan echter een al vervulde of afgewezen native promise uit een andere ECMAScript-realm in een nieuwe promise verpakken. Het overnemen van de toestand kost dan extra asynchrone stappen. Daardoor kan een gewone waarde of een al vervulde of afgewezen promise uit dezelfde realm winnen, ook als die later in de iteratie aan bod komt. De handlers voor het resultaat worden nog steeds asynchroon uitgevoerd.
Promise.race([]) blijft voor altijd pending. Een fout bij het ophalen van de iterator of tijdens het itereren leidt tot afwijzing van de resultaatpromise. De methode annuleert verliezende bewerkingen niet: daarvoor is een apart mechanisme nodig.
In het voorbeeld blijft pending altijd pending. Promise.resolve geeft de twee andere promises ongewijzigd terug. De afgewezen promise komt vóór de vervulde, dus het resultaat is rejected: failed. De regel sync verschijnt eerder omdat de aan then meegegeven handler niet op de huidige callstack wordt uitgevoerd.
Voorbeelden
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");Resultaat
sync rejected: failed
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.