Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Promise.any — prvi uspješan rezultat

Promise.any prihvaća iterabilni objekt i vraća obećanje koje se ispunjava prvim uspješnim rezultatom koji metoda zabilježi. Odbijanja pojedinačnih ulaza ne prekidaju čekanje, osim ako su odbijeni svi ulazi; tada se rezultat odbija s AggregateError.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

Promise.any(iterable)

Promise.any(iterable) statička je metoda objekta Promise, uvedena u ECMAScriptu 2021 (ES12). Prihvaća sinkroni iterabilni objekt, primjerice polje obećanja, običnih vrijednosti ili objekata s metodom then (thenables). Vrijednosti se pretvaraju pomoću Promise.resolve; nemojte predavati funkcije očekujući da će ih metoda pozvati.

Vraćeno obećanje preuzima vrijednost prvog ispunjenja koje Promise.any zabilježi. To nije nužno ispunjenje koje se dogodilo najranije. Ako proslijedite dva obična, već ispunjena obećanja i ugrađena metoda Promise.resolve vrati oba neizmijenjena, pobjeđuje prvo u redoslijedu iteracije, čak i ako se ispunilo poslije drugog. Ugrađena metoda Promise.resolve vraća obećanje neizmijenjeno ako je vrijednost njegova svojstva constructor istovjetna vrijednosti this pri pozivu. Ne provjerava iz kojeg okruženja za izvršavanje (realm) obećanje dolazi. Ako prvo obećanje dolazi iz drugog okruženja i ima svoj zadani konstruktor, lokalna metoda Promise.resolve omata ga u novo obećanje. To odgađa reakciju na njegovo ispunjenje pa drugo može pobijediti ako se vrati neizmijenjeno. No ako je vrijednost svojstva constructor prvog obećanja lokalni Promise, lokalna metoda Promise.resolve vraća ga neizmijenjeno unatoč njegovu podrijetlu. Kod Promise.race odbijanje ulaza može odrediti rezultat ako ga metoda zabilježi prije bilo kojeg drugog ispunjenja ili odbijanja. Kod Promise.any odbijanja ulaza dovode do odbijanja rezultata s AggregateError tek kad su svi ulazi odbijeni. To vrijedi i kad je odbijen jedini zadani ulaz. Metoda nakon uspjeha ne otkazuje ostale operacije.

Ako se odbiju svi ulazi, rezultat se odbija s AggregateError. Njegovo polje errors sadrži razloge redoslijedom ulaza, a ne redoslijedom odbijanja. Promise.any([]) vraća već odbijeno obećanje s praznim poljem errors; obrađivači se i dalje izvršavaju asinkrono. Pogreška pri čitanju iteratora također može odbiti rezultat, bez AggregateError.

Upotrijebite ovu metodu kada je dovoljan jedan uspješan rezultat. Izostanak uspjeha obradite pomoću try/catch oko await ili pomoću .catch(). Jezična specifikacija ne potvrđuje podršku u određenom pregledniku: provjerite ciljano okruženje, primjerice pomoću typeof Promise.any === "function". Prisutnost Nodea 24 u repozitoriju ne dokazuje podršku u preglednicima.

Primjeri

async function main() {
  const value = await Promise.any([
    Promise.reject("offline"),
    Promise.resolve("ready")
  ]);
  console.log(value);

  try {
    await Promise.any([
      Promise.reject("first"),
      Promise.reject("second")
    ]);
  } catch (error) {
    console.log(error instanceof AggregateError);
    console.log(JSON.stringify(error.errors));
  }
}

main().catch(console.error);

Rezultat

ready
true
["first","second"]

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori