CKTIS / JavaScript
Promise — wynik operacji i funkcje resolve oraz reject
Promise reprezentuje przyszły wynik lub przyczynę niepowodzenia. Poznaj synchroniczne wykonanie executora, funkcje resolve i reject oraz asynchroniczną obsługę wyniku przez then i catch.
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
new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);Promise reprezentuje wynik operacji, która może zakończyć się później. Ma stan pending, fulfilled albo rejected; dwa ostatnie są ostateczne. Samo utworzenie obietnicy nie przenosi pracy do innego wątku.
new Promise(executor) wywołuje executor synchronicznie z funkcjami resolve i reject. resolve(value) spełnia obietnicę zwykłą wartością albo przejmuje wynik obietnicy lub obiektu thenable, czyli obiektu z wywoływalną metodą then. reject(reason) odrzuca obietnicę; jako przyczynę warto przekazywać Error. Pierwsze wywołanie jednej z tych funkcji blokuje następne, nawet gdy przejmowany wynik pozostaje w stanie pending. Zatem rozstrzygnięcie przez resolve nie zawsze oznacza natychmiastowe spełnienie.
Wartość zwrócona przez executor jest ignorowana. Wyjątek rzucony synchronicznie w executorze powoduje odrzucenie, chyba że wcześniej wywołano już resolve lub reject. Obsługa przez then następuje asynchronicznie, po zakończeniu bieżącego wykonania. then zwraca nową obietnicę: zwrócona wartość określa jej wynik, a rzucony wyjątek powoduje odrzucenie. catch obsługuje odrzucenia.
W przykładzie executor wypisuje executor, a kod synchroniczny wypisuje sync przed result: 42. Wywołanie reject po resolve(21) jest ignorowane. Przykład wymaga środowiska z Promise i console; nie zakłada dostępności dodatkowych Web APIs ani konkretnej wersji przeglądarki.
Przykłady
const promise = new Promise((resolve, reject) => {
console.log("executor");
resolve(21);
reject(new Error("ignored"));
});
promise
.then(value => value * 2)
.then(value => console.log(`result: ${value}`))
.catch(error => console.log(error.message));
console.log("sync");Wynik
executor sync result: 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.