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

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

Източници