Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Promise — výsledky operací a funkce resolve/reject

Promise představuje budoucí výsledek nebo důvod selhání. Poznejte, jak se executor spouští synchronně, jak funkce resolve a reject určují výsledek a jak jej then a catch zpracovávají asynchronně.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);

Promise představuje výsledek operace, která může skončit až později. Jeho stav je pending, fulfilled nebo rejected; poslední dva stavy jsou konečné. Vytvoření promise samo o sobě nepřesouvá práci do jiného vlákna.

Při volání new Promise(executor) se executor zavolá synchronně a dostane funkce resolve a reject. resolve(value) splní promise běžnou hodnotou nebo převezme výsledek promise či thenable, tedy objektu s volatelnou metodou then. reject(reason) promise zamítne; jako důvod je vhodné použít Error. První volání jedné z těchto funkcí zablokuje další volání, i když převzatý výsledek zůstává ve stavu pending. Vyřešení tedy neznamená vždy okamžité splnění.

Návratová hodnota executor se ignoruje. Synchronně vyhozená výjimka uvnitř executor promise zamítne, pokud už nebylo zavoláno resolve nebo reject. Handlery zaregistrované pomocí then se spustí asynchronně po dokončení aktuálního běhu. then vrací novou promise: vrácená hodnota určí její výsledek, zatímco vyhozená výjimka ji zamítne. catch zpracovává zamítnutí.

V příkladu executor vypíše executor a synchronní kód vypíše sync před result: 42. Volání reject po resolve(21) nemá žádný účinek. Příklad vyžaduje běhové prostředí s Promise a console; nepředpokládá další Web API ani konkrétní verzi prohlížeče.

Příklady

const promise = new Promise((resolve, reject) => {
  console.log("executor");
  resolve(21);
  reject(new Error("ignored"));
});

promise
  .then(value => value * 2)
  .then(value => console.log(`result: ${value}`))
  .catch(error => console.log(error.message));

console.log("sync");

Výsledek

executor
sync
result: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje