Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Promise.prototype.then — łączenie operacji asynchronicznych

Promise.prototype.then rejestruje obsługę spełnienia lub odrzucenia obietnicy i zwraca nową obietnicę. Wynik procedury obsługi wyznacza dalszy przebieg łańcucha.

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.then(onFulfilled, onRejected)

Promise.prototype.then przyjmuje opcjonalne procedury onFulfilled i onRejected. Pierwsza otrzymuje wartość spełnienia, druga — powód odrzucenia. Wywołanie zwraca nową obietnicę; procedury wykonują się asynchronicznie, po zakończeniu bieżącego kodu synchronicznego, nawet gdy obietnica jest już rozstrzygnięta.

Zwrócona zwykła wartość spełnia nową obietnicę, a rzucony wyjątek ją odrzuca. Zwrócenie obietnicy lub obiektu z wywoływalną metodą then powoduje przyjęcie jego ostatecznego wyniku. Brak return oznacza wynik undefined. Zwracaj operacje asynchroniczne, aby łańcuch na nie czekał.

Argumenty, których nie można wywołać, są traktowane jak brak procedury: wartość spełnienia lub powód odrzucenia przechodzi dalej. onRejected nie przechwytuje wyjątku rzuconego przez onFulfilled w tym samym wywołaniu then; obsłuż go w kolejnym ogniwie. Zwykły zwrot z onRejected pozwala odzyskać ścieżkę spełnienia.

To mechanizm ECMAScript, nie interfejs Web API. Metoda wymaga rzeczywistej obietnicy jako this; samo posiadanie metody then nie wystarcza. Przykład pokazuje odroczenie obsługi, przekształcenie wartości i odzyskanie po błędzie.

Przykłady

console.log('start');

Promise.resolve(3)
  .then(value => value * 2)
  .then(value => {
    console.log(value);
    throw new Error('boom');
  })
  .then(undefined, error => {
    console.log(error.message);
    return 9;
  })
  .then(value => console.log(value));

console.log('end');

Wynik

start
end
6
boom
9

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła