Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Zapisi rezultata metode Promise.allSettled()

`Promise.allSettled()` vraća obećanje koje se nakon završetka svih ulaznih obećanja ispunjava nizom rezultata u ulaznom redoslijedu. `status` određuje treba li čitati `value` ili `reason`.

Verzija: 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) statička je metoda objekta Promise koja prima sinkrono iterabilan objekt, primjerice niz. Svaku stavku obrađuje kao Promise.resolve(): preuzima ishod objekata tipa thenable, a obične vrijednosti koristi kao vrijednosti ispunjenja. Kada se sva ulazna obećanja ispune ili odbiju, vraćeno se obećanje ispuni nizom s jednim rezultatom po stavci, redoslijedom iteracije, a ne redoslijedom završavanja.

Svaki zapis rezultata običan je objekt JavaScripta. Uz status: "fulfilled" ima vlastito svojstvo value, ali nema vlastito svojstvo reason. Uz status: "rejected" ima vlastito svojstvo reason, ali nema vlastito svojstvo value. Najprije provjeri status: 0 i undefined mogu biti valjane vrijednosti ispunjenja, a razlog odbijanja ne mora biti objekt Error i također može biti undefined.

Za razliku od Promise.all(), pojedinačno odbijanje bilježi se u nizu i samo po sebi ne dovodi do odbijanja zajedničkog obećanja. Tako možeš zadržati uspješne rezultate neovisnih zadataka i zasebno obraditi neuspjehe. Pogreška pri čitanju iterabilnog objekta ipak može dovesti do odbijanja zajedničkog obećanja umjesto stvaranja zapisa rezultata.

Za prazan ulaz metoda vraća obećanje koje je već ispunjeno s [], no funkcija proslijeđena metodi .then() svejedno se izvodi asinkrono. Za neprazan ulaz, uz standardno ponašanje obećanja, zajedničko je obećanje još na čekanju kada ga metoda vrati, čak i ako nijedno ulazno obećanje više nije na čekanju. Može ipak biti ispunjeno već pri povratku ako je jedina ulazna stavka nativno obećanje koje Promise.resolve() vraća nepromijenjeno i čija vlastita metoda then sinkrono poziva funkciju za obradu ispunjenja.

Primjeri

{
  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: 0

Drugo se obećanje odbija prije nego što se prvo ispuni, ali njegov zapis ostaje na drugom mjestu. Obična vrijednost `0` daje zapis sa stanjem `"fulfilled"`.

Povezane lekcije

  • JavaScript · Lekcija 15 · Srednje · Verzija: 3

Izvori