CKTIS / JavaScript
Функциите resolve и reject в изпълнителя на Promise
Конструкторът `Promise` подава две функции на изпълнителя. Първото извикване на едната обвързва резултата на обещанието, но то все още може да остане в изчакване.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
new Promise((resolve, reject) => { /* Call resolve(value) or reject(reason). */ });new Promise(executor) изисква функция и я извиква синхронно с resolve като първи аргумент и reject като втори. Това са обичайни имена на параметрите; всяка двойка е свързана с едно новосъздадено обещание. И двете функции връщат undefined и могат да се запазят за по-късно извикване, например във функция за обратно извикване. За разлика от тях статичните методи Promise.resolve() и Promise.reject() връщат обещания.
resolve(value) веднага изпълнява обещанието с дадената стойност, ако тя е примитивна. Подаването на обещанието към собствената му функция resolve води до отхвърляне с TypeError. За всеки друг обект JavaScript прочита свойството then синхронно. Ако прочетената стойност не може да бъде извикана, обещанието се изпълнява веднага със самия обект, дори той да е друго обещание. Ако прочетената стойност може да бъде извикана, обектът е thenable: JavaScript извиква then по-късно. Обещанието следва резултата на този обект и може да остане в изчакване. Изключение при прочитане на then или при извикването му, преди да е извикана някоя от подадените му функции за обратно извикване, също води до отхвърляне.
reject(reason) отхвърля обещанието веднага с посочената причина, без да следва резултата ѝ дори ако самата тя е обещание. Допустима е всяка стойност, но обект Error обикновено е по-полезен. При пропуснат аргумент се използва undefined. Само първото извикване на една от двете функции има ефект, дори ако обещанието още изчаква. Резултатът вече е обвързан (resolved), но обещанието е приключило (settled) едва когато е изпълнено или отхвърлено. Обработчиците, регистрирани с then() и catch(), се изпълняват асинхронно.
Конструкторът пренебрегва стойността, върната от изпълнителя. Изключение, което излиза синхронно от изпълнителя, отхвърля обещанието само ако нито една от двете функции все още не е извикана. Ако нито една не бъде извикана и изпълнителят не хвърли изключение, обещанието остава в изчакване. Избягвайте изпълнител async: конструкторът пренебрегва обещанието, което той връща, така че отхвърлянето му не отхвърля външното обещание.
Примери
{
let finish;
const inner = new Promise((resolve) => {
finish = resolve;
});
const outer = new Promise((resolve, reject) => {
console.log("executor");
resolve(inner);
reject(new Error("ignored"));
});
console.log("after constructor");
outer.then((value) => {
console.log(`fulfilled: ${value}`);
return new Promise((resolve, reject) => {
reject(new Error("failed"));
});
}).catch((reason) => {
console.log(`rejected: ${reason.message}`);
});
finish(42);
}Резултат
executor after constructor fulfilled: 42 rejected: failed
`executor` се извежда преди `after constructor`, защото изпълнителят работи синхронно. `resolve(inner)` обвързва резултата на `outer`, докато `inner` още изчаква, затова `reject(new Error("ignored"))` няма ефект. `finish(42)` изпълнява `inner`; обработчикът извежда `fulfilled: 42`, а след това `catch()` обработва отхвърлянето на отделно обещание със съобщение `failed`.
Свързани уроци
- JavaScript · Урок 14 · Средно · Версия: 3
- JavaScript · Урок 15 · Средно · Версия: 3