CKTIS / JavaScript
Promise.allSettled — uitkomsten van alle promises
Promise.allSettled accepteert een itereerbaar object en retourneert een promise met een array van de uitkomsten van alle elementen. De invoervolgorde blijft behouden en zowel vervulde waarden als afwijsredenen worden vastgelegd.
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.allSettled(iterable)Promise.allSettled(iterable) is een statische methode die beschikbaar is sinds ECMAScript 2020, geen aparte Web-API. De methode accepteert een synchroon itereerbaar object, zoals een array, en verwerkt de elementen volgens Promise.resolve. Gewone waarden zijn dus ook geldige invoer. Ondersteuning in de doelbrowser moet afzonderlijk worden gecontroleerd; de Node-versie die in een repository wordt gebruikt, bewijst die ondersteuning niet.
De geretourneerde promise wordt vervuld met een array zodra alle elementen zijn afgehandeld, door vervulling of afwijzing. De resultaten volgen de invoervolgorde, niet de volgorde waarin ze zijn afgehandeld. Elk resultaat heeft de vorm { status: "fulfilled", value: ... } of { status: "rejected", reason: ... }. Controleer status voordat je value of reason leest.
Anders dan bij Promise.all zorgt de afwijzing van één element er niet voor dat de verzamelde promise wordt afgewezen. Dat betekent niet dat de methode die promise nooit kan afwijzen: ongeldige invoer, zoals null, of een uitzondering tijdens het itereren kan een afwijzing veroorzaken. Als de iteratie zonder fouten wordt voltooid maar een element nooit wordt afgehandeld, blijft de verzamelde promise in behandeling.
Bij lege invoer is de geretourneerde promise al vervuld met [], maar een functie die aan .then wordt doorgegeven, wordt nog steeds asynchroon uitgevoerd. De methode annuleert geen bewerkingen en beperkt de gelijktijdigheid niet; ze verzamelt de uitkomsten.
Voorbeelden
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Resultaat
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]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.