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.