База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Promise.race — първо приключване

Promise.race(iterable) връща promise, която приема стойността при изпълнение или причината за отхвърляне от първия обработен изход. Не чака първия успех и не отменя останалите операции.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Promise.race(iterable)

Promise.race(iterable) е статичен метод, който приема синхронен итерируем обект, например масив. Всеки елемент се обработва чрез Promise.resolve: може да бъде promise, обект с метод then или обикновена стойност.

Резултатът приема първото обработено изпълнение или отхвърляне. Следователно отхвърлянето може да изпревари изпълнението. Ако всички елементи са обикновени стойности без извикваем метод then или вече изпълнени или отхвърлени нативни promises, които Promise.resolve връща непроменени, редът на итерация определя победителя. Но Promise.resolve може да обвие вече изпълнена или отхвърлена нативна promise от друг контекст на ECMAScript (realm) в нова promise. За приемането на състоянието ѝ тогава са нужни допълнителни асинхронни стъпки. Затова обикновена стойност или вече изпълнена или отхвърлена promise от същия контекст може да спечели, дори ако се появи по-късно в итерацията. Обработчиците на резултата продължават да се изпълняват асинхронно.

Promise.race([]) остава в очакване завинаги. Грешка при получаването на итератора или по време на итерацията води до отхвърляне на резултата. Методът не отменя загубилите операции: за спирането им е необходим отделен механизъм.

В примера pending остава в очакване завинаги. Promise.resolve връща другите две promises непроменени. Отхвърлената е преди изпълнената, затова резултатът е rejected: failed. Редът sync се появява по-рано, защото обработчикът, подаден на then, не се изпълнява в текущия стек от извиквания.

Примери

const pending = new Promise(() => {});
const result = Promise.race([
  pending,
  Promise.reject("failed"),
  Promise.resolve("ready")
]);

result.then(
  value => console.log("fulfilled: " + value),
  reason => console.log("rejected: " + reason)
);
console.log("sync");

Резултат

sync
rejected: failed

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници