CKTIS / JavaScript
Promise.all — общ резултат от множество обещания
Promise.all връща едно обещание за всички елементи на итерируем обект. Ако итерацията приключи без грешка и всички елементи дадат стойност, обещанието се изпълнява с масив от резултати в реда на входните елементи. При първото наблюдавано отхвърляне на входно обещание общото обещание се отхвърля. Изключение, хвърлено по време на итерацията, също може да доведе до отхвърлянето му, дори ако нито едно входно обещание не е отхвърлено. Методът не отменя останалите операции.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Promise.all(iterable)Promise.all(iterable) е статичен метод, който приема синхронен итерируем обект, например масив. Връща ново обещание, изпълнено с масив от стойности, когато всички елементи завършат успешно. Обикновените стойности се приемат; обекти с извикваем метод then се усвояват като обещания.
Редът на резултатите следва реда на входа, а не реда на приключване на операциите. Празен вход създава обещание, което вече е изпълнено със []; функциите за обратно извикване, подадени на .then(), все пак се изпълняват асинхронно. При непразен вход с обикновени стойности или изпълнени обещания изпълнението на резултата също е асинхронно.
Първото наблюдавано отхвърляне отхвърля обединеното обещание със същата причина, без да чака останалите да успеят. Това не отменя тяхната работа. Обработвайте отхвърлянията с .catch() или с try/catch около await. Методът не извиква подадените функции: за да съберете резултатите им, извикайте ги и подайте върнатите обещания.
В примера first се изпълнява след second, но резултатът запазва реда на входа. Числото 3 се появява в масива без промяна, а sync се отпечатва преди резултата.
Примери
const first = Promise.resolve().then(() => "A");
const second = Promise.resolve("B");
Promise.all([first, second, 3]).then((values) => {
console.log(JSON.stringify(values));
});
console.log("sync");Резултат
sync ["A","B",3]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.