CKTIS / JavaScript
Promise.resolve — normalizácia hodnoty na promise
Promise.resolve(value) umožňuje zaobchádzať s bežnou hodnotou, promise alebo thenable ako s promise. Môže vrátiť existujúcu promise bez zmeny; resolved neznamená, že výsledok je už dostupný alebo že operácia uspeje.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Promise.resolve(value)Promise.resolve(value) je statická metóda, ktorá normalizuje hodnotu na promise. Ak sa argument vynechá, použije sa undefined. Keď metóda vytvorí novú promise, tá sa splní hodnotou argumentu, ak ide o primitívnu hodnotu alebo o objekt, pri ktorom čítanie vlastnosti then prebehne bez výnimky a vráti hodnotu, ktorú nemožno volať. Ak čítanie vlastnosti then vyhodí výnimku, nová promise sa odmietne a výnimka je dôvodom odmietnutia.
Ak je p skutočná promise, Promise.resolve(p) prečíta jej vlastnosť constructor. Ak čítanie vráti Promise, metóda vráti presne p. Ak getter vlastnosti constructor vyhodí výnimku, metóda ju synchrónne propaguje bez toho, aby vytvorila novú promise. Platí to aj vtedy, keď vyhodnotenie samotného argumentu p prebehne bez chyby. Metóda vytvorí novú promise, ak argument nie je skutočná promise alebo ak čítanie jej vlastnosti constructor vráti inú hodnotu než Promise. Thenable, teda objekt s volateľným then, sa asimiluje a výsledok preberá jeho konečný stav, a to aj cez ďalšie objekty thenable. Odmietnutie zostáva odmietnutím; resolved neznamená fulfilled.
Callbacky odovzdané do .then() sa vykonávajú asynchrónne, aj keď je promise už splnená. Metóda nezachytáva chyby vzniknuté pri vyhodnocovaní argumentu: ak fn() v Promise.resolve(fn()) vyhodí výnimku, volanie ju vyhodí synchrónne. Ak chcete volanie odložiť a zmeniť takúto výnimku na odmietnutie, použite Promise.resolve().then(() => fn()).
Príklady
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");Výsledok
true sync 42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.