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.