CKTIS / JavaScript
Funkcie resolve a reject v executore Promise
Konštruktor `Promise` odovzdá executoru dve funkcie. Prvé volanie jednej z nich záväzne určí výsledok, no prísľub môže ešte zostať v čakajúcom stave.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new Promise((resolve, reject) => { /* Call resolve(value) or reject(reason). */ });new Promise(executor) vyžaduje funkciu a zavolá ju synchrónne s argumentmi resolve a reject v tomto poradí. Sú to obvyklé názvy parametrov; každá dvojica funkcií patrí k jednému novovytvorenému prísľubu. Obe funkcie vracajú undefined a dajú sa uchovať na neskoršie volanie, napríklad v spätne volanej funkcii. Statické metódy Promise.resolve() a Promise.reject() naopak vracajú prísľuby.
resolve(value) prísľub ihneď splní danou hodnotou, ak je primitívna. Odovzdanie prísľubu jeho vlastnej funkcii resolve spôsobí odmietnutie s TypeError. Pri každom inom objekte JavaScript synchrónne prečíta vlastnosť then. Ak prečítaná hodnota nie je volateľná, prísľub sa ihneď splní samotným objektom, aj keď je tento objekt iným prísľubom. Ak je prečítaná hodnota volateľná, objekt je thenable: JavaScript zavolá then až neskôr. Prísľub prevezme výsledok tohto objektu a môže zostať v čakajúcom stave. Prísľub sa odmietne aj pri výnimke počas čítania then alebo počas jeho volania, ak ešte nebola zavolaná žiadna z odovzdaných spätne volaných funkcií.
reject(reason) prísľub ihneď odmietne s uvedeným dôvodom a nepreberá výsledok dôvodu, ani keď je ním prísľub. Dôvodom môže byť ľubovoľná hodnota, no objekt Error býva užitočnejší. Ak sa argument vynechá, použije sa undefined. Počíta sa len prvé volanie jednej z dvojice funkcií, aj keď prísľub ešte čaká. Výsledok je záväzne určený (resolved), ale prísľub je uzavretý (settled) až po splnení alebo odmietnutí. Obslužné funkcie zaregistrované cez then() a catch() sa vykonávajú asynchrónne.
Konštruktor ignoruje návratovú hodnotu executora. Výnimka, ktorá sa z executora synchrónne šíri von, odmietne prísľub len vtedy, ak ešte nebola zavolaná žiadna z oboch funkcií. Ak sa žiadna nezavolá a executor nevyvolá výnimku, prísľub zostane čakať. Nepoužívajte executor async: konštruktor ignoruje prísľub, ktorý executor vráti, takže jeho odmietnutie neodmietne vonkajší prísľub.
Príklady
{
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);
}Výsledok
executor after constructor fulfilled: 42 rejected: failed
`executor` sa vypíše pred `after constructor`, pretože executor beží synchrónne. `resolve(inner)` záväzne určí výsledok `outer`, kým `inner` ešte čaká, takže `reject(new Error("ignored"))` nemá účinok. `finish(42)` splní `inner`; obslužná funkcia vypíše `fulfilled: 42` a potom `catch()` spracuje odmietnutie iného prísľubu so správou `failed`.
Súvisiace lekcie
- JavaScript · Lekcia 14 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 15 · Stredne pokročilá · Verzia: 3