CKTIS / JavaScript
Funkciji resolve in reject v izvajalniku Promise
Konstruktor `Promise` izvajalniku poda dve funkciji. Prvi klic ene od njiju določi izid obljube, vendar lahko ta še vedno ostane v stanju čakanja.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
new Promise((resolve, reject) => { /* Call resolve(value) or reject(reason). */ });new Promise(executor) zahteva funkcijo in jo pokliče sinhrono, najprej z resolve in nato z reject. To sta običajni imeni parametrov; vsak par pripada eni novo ustvarjeni obljubi. Obe funkciji vrneta undefined in ju je mogoče shraniti za poznejši klic, na primer v povratni funkciji. Statični metodi Promise.resolve() in Promise.reject() pa vračata obljube.
resolve(value) takoj izpolni obljubo z vrednostjo, če je ta primitivna. Če obljubo podamo njeni lastni funkciji resolve, se zavrne z TypeError. Pri vsakem drugem objektu JavaScript sinhrono prebere lastnost then. Če prebrana vrednost ni klicljiva, se obljuba takoj izpolni s samim objektom, tudi če je ta objekt druga obljuba. Če je prebrana vrednost klicljiva, je objekt thenable: JavaScript pokliče then pozneje. Obljuba prevzame izid tega objekta in lahko ostane v stanju čakanja. Do zavrnitve pride tudi, če se sproži izjema pri branju then ali pri njegovem klicu, preden je poklicana katera od podanih povratnih funkcij.
reject(reason) takoj zavrne obljubo z navedenim razlogom in ne prevzame njegovega izida, tudi če je razlog sam obljuba. Dovoljena je katera koli vrednost, vendar je objekt Error navadno uporabnejši. Če argument izpustimo, se uporabi undefined. Šteje samo prvi klic ene od funkcij v paru, tudi če obljuba še čaka. Izid je določen (resolved), obljuba pa je zaključena (settled) šele, ko je izpolnjena ali zavrnjena. Obdelovalne funkcije, registrirane z then() in catch(), se izvajajo asinhrono.
Konstruktor prezre vrednost, ki jo vrne izvajalnik. Izjema, ki se iz izvajalnika razširi sinhrono, zavrne obljubo le, če še ni bila poklicana nobena od obeh funkcij. Če nobene ne pokličemo in izvajalnik ne sproži izjeme, obljuba ostane v stanju čakanja. Izogibaj se izvajalniku async: konstruktor prezre obljubo, ki jo ta vrne, zato zavrnitev vrnjene obljube ne zavrne zunanje obljube.
Primeri
{
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);
}Rezultat
executor after constructor fulfilled: 42 rejected: failed
`executor` se izpiše pred `after constructor`, ker se izvajalnik izvaja sinhrono. `resolve(inner)` določi izid `outer`, ko `inner` še čaka, zato `reject(new Error("ignored"))` nima učinka. `finish(42)` izpolni `inner`; obdelovalna funkcija izpiše `fulfilled: 42`, nato pa `catch()` obravnava zavrnitev druge obljube s sporočilom `failed`.
Povezane lekcije
- JavaScript · Lekcija 14 · Srednja · Različica: 3
- JavaScript · Lekcija 15 · Srednja · Različica: 3