CKTIS / JavaScript
Promise.any — prvý úspešný výsledok
Promise.any prijíma iterovateľný objekt a vracia promise, ktorá sa splní prvým úspešným výsledkom, ktorý metóda zaznamená. Zamietnutia jednotlivých vstupov čakanie neukončia, pokiaľ nie sú zamietnuté všetky; v takom prípade sa výsledok zamietne s AggregateError.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Promise.any(iterable)Promise.any(iterable) je statická metóda objektu Promise, ktorá bola uvedená v ECMAScript 2021 (ES12). Prijíma synchrónny iterovateľný objekt, napríklad pole promises, obyčajných hodnôt alebo objektov s metódou then (thenables). Hodnoty sa prevedú pomocou Promise.resolve; neodovzdávajte funkcie s očakávaním, že ich metóda zavolá.
Vrátená promise prevezme hodnotu z prvého splnenia, ktoré Promise.any zaznamená. Nemusí ísť o splnenie, ku ktorému došlo najskôr. Ak odovzdáte dve bežné, už splnené promise a vstavaná metóda Promise.resolve obe vráti bez zmeny, vyhrá prvá v poradí iterácie, aj keď sa splnila neskôr ako druhá. Vstavaná metóda Promise.resolve vráti promise bez zmeny, ak je hodnota jej vlastnosti constructor totožná s hodnotou this pri volaní. Neskúma, z akého prostredia (realmu) promise pochádza. Ak prvá promise pochádza z iného realmu a má svoj predvolený konštruktor, miestna metóda Promise.resolve ju zabalí do novej promise. Tým sa oneskorí reakcia na jej splnenie, takže druhá môže vyhrať, ak sa vráti bez zmeny. Ak je však hodnotou vlastnosti constructor prvej promise miestny Promise, miestna metóda Promise.resolve ju napriek jej pôvodu vráti bez zmeny. Pri Promise.race môže zamietnutie vstupu určiť výsledok, ak ho metóda zaznamená skôr než akékoľvek iné splnenie alebo zamietnutie. Pri Promise.any vedú zamietnutia vstupov k zamietnutiu výsledku s AggregateError až po zamietnutí všetkých vstupov. Platí to aj vtedy, keď je zamietnutý jediný zadaný vstup. Metóda po úspechu nezruší ostatné operácie.
Ak sa zamietnu všetky vstupy, výsledok sa zamietne s AggregateError. Jeho pole errors obsahuje dôvody v poradí vstupov, nie v poradí zamietnutí. Promise.any([]) vráti už zamietnutú promise s prázdnym poľom errors; obslužné funkcie sa napriek tomu vykonajú asynchrónne. Výsledok môže zamietnuť aj chyba pri čítaní iterátora, a to bez AggregateError.
Túto metódu použite, keď stačí jeden úspešný výsledok. Situáciu, keď nič neuspeje, ošetrite pomocou try/catch okolo await alebo pomocou .catch(). Jazyková špecifikácia nepotvrdzuje podporu v konkrétnom prehliadači: overte cieľové prostredie, napríklad pomocou typeof Promise.any === "function". Prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači.
Príklady
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);Výsledok
ready true ["first","second"]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.