CKTIS / JavaScript
Promise.prototype.catch — обработване на отхвърляне
Методът catch() добавя обработчик за отхвърляне на promise. Позволява възстановяване чрез връщане на успешна стойност или препредаване на грешка и със стандартния метод then връща нов promise.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
promise.catch(onRejected)Promise.prototype.catch извиква this.then(undefined, onRejected). Със стандартния метод then връща нов promise, без да променя състоянието на първоначалния promise. Обработчикът onRejected получава причината за отхвърлянето, която не е задължително да бъде обект Error, и се изпълнява асинхронно дори ако promise вече е бил отхвърлен.
Връщането на обикновена стойност от обработчика изпълнява новия promise с тази стойност; ако пропуснете return, резултатът е undefined. Ако върнете promise или обект с извикваем метод then, новият promise приема крайния му резултат. Хвърлянето на грешка отхвърля новия promise. За да препратите грешка, използвайте throw, вместо само да я изведете.
При изпълнен promise обработчикът се пропуска и стойността се предава нататък. Ако onRejected не е функция, отхвърлянето също се предава нататък. catch, поставен след then, обработва и грешки, хвърлени в тази предходна стъпка, но не и грешки в по-късни стъпки или в независими асинхронни операции, които не са били върнати.
Примери
Promise.resolve(10)
.then(() => {
throw new Error("failed");
})
.catch((error) => {
console.log(error.message);
return 42;
})
.then((value) => {
console.log(value);
});
console.log("sync");Резултат
sync failed 42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.