Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Promise — rezultati operacij in funkciji resolve/reject

Promise predstavlja prihodnji rezultat ali razlog za napako. Spoznajte, kako se executor izvede sinhrono, kako funkciji resolve in reject določita izid ter kako ga then in catch obravnavata asinhrono.

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

Sintaksa

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

Promise predstavlja rezultat operacije, ki se lahko konča šele pozneje. Njegovo stanje je pending, fulfilled ali rejected; zadnji dve stanji sta končni. Ustvarjanje obljube samo po sebi ne premakne dela v drugo nit.

Pri klicu new Promise(executor) se executor izvede sinhrono in prejme funkciji resolve in reject. resolve(value) izpolni obljubo z običajno vrednostjo ali prevzame izid obljube oziroma thenablea, torej objekta s klicljivo metodo then. reject(reason) obljubo zavrne; kot razlog je priporočljivo uporabiti Error. Prvi klic ene od teh funkcij onemogoči nadaljnje klice, tudi če prevzeti izid ostane v stanju pending. Razrešitev torej ne pomeni vedno takojšnje izpolnitve.

Vrnjena vrednost executorja se prezre. Sinhrona izjema, vržena znotraj njega, zavrne obljubo, razen če je bil resolve ali reject že poklican. Obdelovalniki, registrirani z then, se izvedejo asinhrono, ko se trenutna izvedba konča. then vrne novo obljubo: vrnjena vrednost določi njen izid, vržena izjema pa jo zavrne. catch obravnava zavrnitve.

V primeru executor izpiše executor, sinhrona koda pa pred result: 42 izpiše sync. Klic reject po resolve(21) nima učinka. Primer zahteva izvajalno okolje z Promise in console; ne predpostavlja dodatnih spletnih API-jev ali določene različice brskalnika.

Primeri

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");

Rezultat

executor
sync
result: 42

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri