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

CKTIS / JavaScript

Promise.resolve — normalizacija vrednosti v promise

Promise.resolve(value) omogoča, da običajno vrednost, promise ali thenable obravnavamo kot promise. Obstoječo promise lahko vrne nespremenjeno; resolved ne pomeni, da je rezultat že na voljo ali da bo operacija uspela.

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

Promise.resolve(value)

Promise.resolve(value) je statična metoda za normalizacijo vrednosti v promise. Če argument izpustimo, se uporabi undefined. Ko metoda ustvari novo promise, se ta izpolni z vrednostjo argumenta, če je argument primitivna vrednost ali objekt, pri katerem branje lastnosti then ne sproži izjeme in vrne vrednost, ki je ni mogoče poklicati. Če branje lastnosti then sproži izjemo, se nova promise zavrne, razlog za zavrnitev pa je ta izjema.

Če je p prava promise, Promise.resolve(p) prebere njeno lastnost constructor. Če branje vrne Promise, metoda vrne natanko p. Če getter lastnosti constructor sproži izjemo, jo metoda sinhrono posreduje naprej, ne da bi ustvarila novo promise. To velja tudi, če vrednotenje samega argumenta p poteka brez napake. Metoda ustvari novo promise, če argument ni prava promise ali če branje njene lastnosti constructor vrne vrednost, ki ni Promise. Objekt thenable, torej objekt z atributom then, ki ga je mogoče poklicati, se asimilira, rezultat pa sledi njegovemu končnemu izidu, tudi prek nadaljnjih objektov thenable. Zavrnitev ostane zavrnitev; resolved ne pomeni fulfilled.

Povratne funkcije, podane v .then(), se izvedejo asinhrono, tudi če je promise že izpolnjena. Metoda ne prestreže napak, ki nastanejo pri vrednotenju argumenta: če fn() v Promise.resolve(fn()) sproži izjemo, jo klic sproži sinhrono. Če želite klic odložiti in tako izjemo spremeniti v zavrnitev, uporabite Promise.resolve().then(() => fn()).

Primeri

const p = Promise.resolve(7);
console.log(Promise.resolve(p) === p);

const thenable = { then(resolve) { resolve(42); } };
Promise.resolve(thenable).then(value => console.log(value));
console.log("sync");

Rezultat

true
sync
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