CKTIS / JavaScript
Zapisi rezultatov metode Promise.allSettled()
`Promise.allSettled()` vrne obljubo, ki se po zaključku vseh vhodnih obljub izpolni s tabelo rezultatov v vhodnem vrstnem redu. `status` pove, ali je treba prebrati `value` ali `reason`.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
Promise.allSettled(iterable)
// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }Promise.allSettled(iterable) je statična metoda objekta Promise, ki sprejme sinhrono iterabilen objekt, na primer tabelo. Vsak element obravnava tako kot Promise.resolve(): prevzame izid objektov thenable, navadne vrednosti pa uporabi kot vrednosti izpolnitve. Ko so vse vhodne obljube izpolnjene ali zavrnjene, se vrnjena obljuba izpolni s tabelo, ki vsebuje en rezultat na element, po vrstnem redu iteracije in ne po vrstnem redu zaključka.
Vsak zapis rezultata je navaden objekt JavaScript. Pri status: "fulfilled" ima lastno lastnost value, nima pa lastne lastnosti reason. Pri status: "rejected" ima lastno lastnost reason, nima pa lastne lastnosti value. Najprej preveri status: 0 in undefined sta lahko veljavni vrednosti izpolnitve, razlog za zavrnitev pa ni nujno objekt Error in je prav tako lahko undefined.
V nasprotju z Promise.all() se posamezna zavrnitev zabeleži v tabeli in sama po sebi ne povzroči zavrnitve skupne obljube. Tako lahko ohraniš uspešne rezultate neodvisnih opravil in neuspehe obravnavaš ločeno. Napaka pri branju iterabilnega objekta pa lahko povzroči zavrnitev skupne obljube, namesto da bi nastal zapis rezultata.
Pri praznem vhodu metoda vrne obljubo, ki je že izpolnjena z [], vendar se funkcija, podana metodi .then(), vseeno izvede asinhrono. Pri nepraznem vhodu in standardnem obnašanju obljub je skupna obljuba ob vrnitvi še v teku, tudi če nobena vhodna obljuba ni več v teku. Lahko pa je izpolnjena že ob vrnitvi, če je edini vhodni element vgrajena obljuba, ki jo Promise.resolve() vrne nespremenjeno in katere lastna metoda then sinhrono pokliče funkcijo za obravnavo izpolnitve.
Primeri
{
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}`);
}
}
});
}Rezultat
[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0Druga obljuba je zavrnjena, preden se prva izpolni, vendar njen zapis ostane na drugem mestu. Navadna vrednost `0` ustvari zapis s stanjem `"fulfilled"`.
Povezane lekcije
- JavaScript · Lekcija 15 · Srednja · Različica: 3