Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła