CKTIS / JavaScript
Promise.all — één resultaat uit meerdere promises
Promise.all geeft één promise terug voor alle elementen van een iterable. Als de iteratie zonder fouten verloopt en alle elementen een waarde opleveren, wordt de promise vervuld met een array van resultaten in invoervolgorde. Bij de eerste waargenomen afwijzing van een invoerpromise wordt de gecombineerde promise afgewezen. Ook een exception die tijdens de iteratie wordt gegooid, kan tot afwijzing leiden, zelfs als geen enkele invoerpromise wordt afgewezen. De methode 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.all(iterable)Promise.all(iterable) is een statische methode die een synchrone iterable accepteert, zoals een array. De methode geeft een nieuwe promise terug die wordt vervuld met een array van waarden wanneer alle elementen slagen. Gewone waarden zijn toegestaan; objecten met een aanroepbare then-methode worden als promises overgenomen.
De volgorde van de resultaten volgt de invoervolgorde, niet de volgorde waarin de bewerkingen worden afgerond. Een lege invoer levert een promise op die al met [] is vervuld; callbacks die aan .then() zijn doorgegeven, worden nog steeds asynchroon uitgevoerd. Bij een niet-lege invoer met gewone waarden of vervulde promises is ook de vervulling van het resultaat asynchroon.
De eerste waargenomen afwijzing wijst de gecombineerde promise af met dezelfde reden, zonder te wachten tot de andere slagen. Dit annuleert hun werk niet. Handel afwijzingen af met .catch() of met try/catch rond await. De methode roept de opgegeven functies niet aan: roep ze aan en geef de teruggegeven promises door om hun resultaten te verzamelen.
In het voorbeeld wordt first na second vervuld, maar het resultaat behoudt de invoervolgorde. Het getal 3 staat ongewijzigd in de array en sync wordt vóór het resultaat afgedrukt.
Voorbeelden
const first = Promise.resolve().then(() => "A");
const second = Promise.resolve("B");
Promise.all([first, second, 3]).then((values) => {
console.log(JSON.stringify(values));
});
console.log("sync");Resultaat
sync ["A","B",3]
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.