CKTIS / JavaScript
Resultaatobjecten van Promise.allSettled()
`Promise.allSettled()` geeft een promise terug die, zodra alle invoerpromises zijn afgehandeld, wordt vervuld met een array in invoervolgorde. `status` bepaalt of je `value` of `reason` leest.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
Promise.allSettled(iterable)
// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }Promise.allSettled(iterable) is een statische methode van Promise die een synchrone iterable aanneemt, zoals een array. De methode behandelt elk element zoals Promise.resolve() dat doet: ze neemt de uitkomst van thenables over en gebruikt gewone waarden als vervullingswaarden. Zodra elke invoerpromise is vervuld of afgewezen, wordt de teruggegeven promise vervuld met een array met één resultaat per element, in iteratievolgorde en niet in de volgorde van afhandeling.
Elk resultaat is een gewoon JavaScript-object. Bij status: "fulfilled" heeft het een eigen eigenschap value, maar geen eigen eigenschap reason. Bij status: "rejected" heeft het een eigen eigenschap reason, maar geen eigen eigenschap value. Controleer eerst status: 0 en undefined kunnen geldige vervullingswaarden zijn, en een afwijzingsreden hoeft geen Error te zijn en kan ook undefined zijn.
Anders dan bij Promise.all() wordt een afzonderlijke afwijzing in de array vastgelegd en zorgt die op zichzelf niet voor afwijzing van de gezamenlijke promise. Zo kun je succesvolle resultaten van onafhankelijke taken behouden en fouten apart afhandelen. Een fout bij het uitlezen van de iterable kan de gezamenlijke promise wél afwijzen in plaats van een resultaatobject op te leveren.
Bij lege invoer retourneert de methode een promise die al met [] is vervuld, maar een callback voor .then() draait nog steeds asynchroon. Bij niet-lege invoer is de gezamenlijke promise bij standaardgedrag nog niet afgehandeld wanneer de methode haar teruggeeft, ook als alle invoerpromises al zijn afgehandeld. Ze kan bij teruggave wel al vervuld zijn als het enige invoerelement een native promise is die Promise.resolve() ongewijzigd teruggeeft en waarvan de eigen then-methode de vervullingscallback synchroon aanroept.
Voorbeelden
{
let finishFirst;
const first = new Promise((resolve) => { finishFirst = resolve; });
const second = Promise.reject("offline");
const batch = Promise.allSettled([first, second, 0]);
finishFirst("profile");
batch.then((results) => {
console.log(JSON.stringify(results));
for (const result of results) {
if (result.status === "fulfilled") {
console.log(`value: ${result.value}`);
} else {
console.log(`reason: ${result.reason}`);
}
}
});
}Resultaat
[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0De tweede promise wordt afgewezen voordat de eerste wordt vervuld, maar zijn resultaatobject staat nog steeds op de tweede plaats. De gewone waarde `0` levert een object met status `"fulfilled"` op.
Gerelateerde lessen
- JavaScript · Les 15 · Gemiddeld · Versie: 3