Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Promise.any — prvi uspešni rezultat

Promise.any sprejme iterabilni objekt in vrne obljubo, ki se izpolni s prvim uspešnim rezultatom, ki ga metoda zazna. Zavrnitev posameznih vhodov ne konča čakanja, razen če so zavrnjeni vsi; v tem primeru se rezultat zavrne z AggregateError.

Različica: 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) je statična metoda objekta Promise, uvedena v ECMAScript 2021 (ES12). Sprejme sinhroni iterabilni objekt, na primer polje obljub, navadnih vrednosti ali objektov z metodo then (thenables). Vrednosti se pretvorijo prek Promise.resolve; ne podajajte funkcij v pričakovanju, da jih bo metoda poklicala.

Vrnjena obljuba prevzame vrednost prve izpolnitve, ki jo zazna Promise.any. To ni nujno izpolnitev, do katere je prišlo najprej. Če podate dve običajni, že izpolnjeni obljubi in ju vgrajena metoda Promise.resolve vrne nespremenjeni, zmaga prva v vrstnem redu iteracije, tudi če se je izpolnila pozneje kot druga. Vgrajena metoda Promise.resolve vrne obljubo nespremenjeno, če je vrednost njene lastnosti constructor enaka vrednosti this ob klicu. Ne preverja, iz katerega okolja izvajanja (realm) izvira obljuba. Če prva obljuba izvira iz drugega okolja in ima svoj privzeti konstruktor, jo lokalna metoda Promise.resolve ovije v novo obljubo. To zakasni odziv na njeno izpolnitev, zato lahko zmaga druga, če je vrnjena nespremenjena. Če pa je vrednost lastnosti constructor prve obljube lokalni Promise, jo lokalna metoda Promise.resolve kljub njenemu izvoru vrne nespremenjeno. Pri Promise.race lahko zavrnitev vhoda določi rezultat, če jo metoda zazna pred katero koli drugo izpolnitvijo ali zavrnitvijo. Pri Promise.any zavrnitve vhodov povzročijo zavrnitev rezultata z AggregateError šele, ko so zavrnjeni vsi vhodi. To velja tudi, če je zavrnjen edini podani vhod. Metoda po uspehu ne prekliče preostalih operacij.

Če so zavrnjeni vsi vhodi, se rezultat zavrne z AggregateError. Njegovo polje errors vsebuje razloge v vrstnem redu vhodov, ne v vrstnem redu zavrnitev. Promise.any([]) vrne že zavrnjeno obljubo s praznim poljem errors; obravnavalniki se kljub temu izvedejo asinhrono. Rezultat lahko zavrne tudi napaka pri branju iteratorja, vendar brez AggregateError.

To metodo uporabite, kadar zadostuje en uspešen rezultat. Primer, ko ni uspeha, obravnavajte z try/catch okoli await ali z .catch(). Jezikovna specifikacija ne potrjuje podpore v določenem brskalniku: preverite ciljno okolje, na primer z typeof Promise.any === "function". Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.

Primeri

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"]

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri