KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen