Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Promise.prototype.catch — obsługa odrzucenia

Metoda catch() dołącza funkcję obsługującą odrzucenie obietnicy. Pozwala odzyskać poprawny wynik albo przekazać błąd dalej, a przy standardowym then zwraca nową obietnicę.

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.catch(onRejected)

Promise.prototype.catch wywołuje this.then(undefined, onRejected). Przy standardowym then zwraca nową obietnicę, nie zmieniając stanu pierwotnej. Funkcja onRejected otrzymuje powód odrzucenia, niekoniecznie obiekt Error, i jest wykonywana asynchronicznie, także gdy obietnica była już odrzucona.

Zwrócenie zwykłej wartości z funkcji obsługi spełnia nową obietnicę tą wartością; brak return daje undefined. Zwrócenie obietnicy lub obiektu z wywoływalnym then powoduje przyjęcie jego ostatecznego wyniku. Wyrzucenie błędu odrzuca nową obietnicę. Aby przekazać błąd dalej, użyj throw, zamiast tylko go wypisywać.

Spełnienie obietnicy omija funkcję obsługi i przekazuje wartość dalej. Jeśli onRejected nie jest funkcją, odrzucenie również przechodzi dalej. Umieszczone po then wywołanie catch obsługuje także błędy wyrzucone w tym wcześniejszym kroku, ale nie w późniejszych krokach ani w niezwróconych, niezależnych operacjach asynchronicznych.

Przykłady

Promise.resolve(10)
  .then(() => {
    throw new Error("failed");
  })
  .catch((error) => {
    console.log(error.message);
    return 42;
  })
  .then((value) => {
    console.log(value);
  });
console.log("sync");

Wynik

sync
failed
42

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

Źródła