CKTIS / JavaScript
Promise.resolve — normalizacja wartości do obietnicy
Promise.resolve(value) pozwala traktować zwykłą wartość, obietnicę lub obiekt thenable jako obietnicę. Może zwrócić istniejącą obietnicę bez zmian; resolved nie oznacza, że wynik jest już dostępny ani że operacja zakończy się sukcesem.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Promise.resolve(value)Promise.resolve(value) to metoda statyczna służąca do normalizacji wartości do obietnicy. Pominięcie argumentu oznacza undefined. Gdy metoda tworzy nową obietnicę, zostaje ona spełniona wartością pierwotną lub samym obiektem, jeśli odczyt jego właściwości then przebiegnie bez wyjątku i zwróci wartość, której nie można wywołać. Jeśli odczyt then rzuci wyjątek, nowa obietnica zostaje odrzucona z tym wyjątkiem jako powodem.
Jeśli p jest rzeczywistą obietnicą, Promise.resolve(p) odczytuje jej właściwość constructor. Jeśli odczyt zwróci Promise, metoda zwraca dokładnie p. Jeśli getter constructor rzuci wyjątek, metoda propaguje go synchronicznie, zanim utworzy nową obietnicę, nawet jeśli obliczenie samego argumentu p przebiegło bez błędu. Metoda tworzy nową obietnicę, gdy argument nie jest rzeczywistą obietnicą lub gdy odczyt jej constructor zwróci wartość inną niż Promise. Obiekt thenable, czyli obiekt z wywoływalnym then, jest asymilowany, a wynik podąża za jego rozstrzygnięciem, również przez kolejne thenable. Odrzucenie pozostaje odrzuceniem; resolved nie znaczy fulfilled.
Funkcje przekazane do .then() wykonują się asynchronicznie, nawet gdy obietnica jest już spełniona. Metoda nie przechwytuje wyjątków z obliczania argumentu: jeśli fn() rzuci wyjątek w Promise.resolve(fn()), wywołanie rzuci go synchronicznie. Aby odroczyć wywołanie i zamienić taki wyjątek w odrzucenie, użyj Promise.resolve().then(() => fn()).
Przykłady
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");Wynik
true sync 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.