CKTIS / JavaScript
Promise.any — първият успешен резултат
Promise.any приема итерируем обект и връща promise, който се изпълнява с първия успешен резултат, отчетен от метода. Отхвърлянията на отделни входове не прекратяват изчакването, освен ако не бъдат отхвърлени всички; тогава резултатът се отхвърля с AggregateError.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Promise.any(iterable)Promise.any(iterable) е статичен метод на Promise, въведен в ECMAScript 2021 (ES12). Приема синхронен итерируем обект, например масив от promise обекти, обикновени стойности или обекти с метод then (thenables). Стойностите се преобразуват чрез Promise.resolve; не подавайте функции с очакването методът да ги извика.
Върнатият promise приема стойността от първото изпълнение, отчетено от Promise.any. Това не е непременно изпълнението, настъпило най-рано. Ако подадете два обикновени, вече изпълнени promise обекта и вграденият метод Promise.resolve върне и двата непроменени, печели първият по ред на обхождане, дори да се е изпълнил по-късно от втория. Вграденият метод Promise.resolve връща promise обект непроменен, ако стойността на свойството му constructor съвпада със стойността на this при извикването. Методът не проверява от коя среда за изпълнение (realm) е обектът. Ако първият promise обект е от друга среда и е със своя конструктор по подразбиране, локалният метод Promise.resolve го обвива в нов promise обект. Това забавя реакцията при изпълнението му, така че вторият може да спечели, ако бъде върнат непроменен. Ако обаче стойността на свойството constructor на първия promise обект е локалният Promise, локалният метод Promise.resolve връща обекта непроменен въпреки произхода му. При Promise.race отхвърлянето на вход може да определи резултата, ако методът го отчете преди всяко друго изпълнение или отхвърляне. При Promise.any отхвърлянията на входовете водят до отхвърляне на резултата с AggregateError едва когато всички входове бъдат отхвърлени. Това важи и когато единственият подаден вход бъде отхвърлен. След успех методът не отменя останалите операции.
Ако всички входове бъдат отхвърлени, резултатът се отхвърля с AggregateError. Неговият масив errors съдържа причините в реда на входовете, а не в реда на отхвърлянията. Promise.any([]) връща вече отхвърлен promise с празен масив errors; обработчиците все пак се изпълняват асинхронно. Грешка при прочитането на итератора също може да отхвърли резултата, но без AggregateError.
Използвайте този метод, когато е достатъчен един успешен резултат. Обработете липсата на успех с try/catch около await или с .catch(). Езиковата спецификация не потвърждава поддръжка в конкретен браузър: проверете целевата среда, например с typeof Promise.any === "function". Наличието на Node 24 в хранилище не доказва поддръжка в браузърите.
Примери
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);Резултат
ready true ["first","second"]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.