CKTIS / JavaScript
Promise.resolve — normalizace hodnoty na promise
Promise.resolve(value) umožňuje zacházet s běžnou hodnotou, promise nebo thenable jako s promise. Může vrátit existující promise beze změny; resolved neznamená, že je výsledek už dostupný nebo že operace uspěje.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.resolve(value)Promise.resolve(value) je statická metoda, která normalizuje hodnotu na promise. Při vynechání argumentu se použije undefined. Pokud metoda vytvoří novou promise, ta se splní hodnotou argumentu, je-li to primitivní hodnota nebo objekt, u kterého čtení vlastnosti then proběhne bez výjimky a vrátí nevolatelnou hodnotu. Pokud čtení vlastnosti then vyhodí výjimku, nová promise se odmítne a tato výjimka je důvodem odmítnutí.
Je-li p skutečná promise, Promise.resolve(p) přečte její vlastnost constructor. Pokud čtení vrátí Promise, metoda vrátí přesně p. Pokud getter vlastnosti constructor vyhodí výjimku, metoda ji synchronně předá dál, aniž by vytvořila novou promise. To platí i tehdy, když vyhodnocení samotného argumentu p proběhne bez chyby. Metoda vytvoří novou promise, pokud argument není skutečná promise nebo pokud čtení její vlastnosti constructor vrátí jinou hodnotu než Promise. Thenable, tedy objekt s volatelným then, je asimilován a výsledek přebírá jeho konečný stav, a to i přes další objekty thenable. Odmítnutí zůstává odmítnutím; resolved neznamená fulfilled.
Callbacky předané do .then() se spouštějí asynchronně, i když je promise už splněná. Metoda nezachytává chyby vzniklé při vyhodnocování argumentu: pokud fn() v Promise.resolve(fn()) vyhodí výjimku, volání ji vyhodí synchronně. Chcete-li volání odložit a převést takovou výjimku na odmítnutí, použijte Promise.resolve().then(() => fn()).
Pří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ýsledek
true sync 42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.