CKTIS / JavaScript
Promise.prototype.catch — obravnavanje zavrnitev
Metoda catch() doda obravnavo zavrnitve obljube. Omogoča, da nadaljujete z uspešno vrednostjo ali napako posredujete naprej; s standardno metodo then vrne novo obljubo.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
promise.catch(onRejected)Promise.prototype.catch pokliče this.then(undefined, onRejected). S standardno metodo then vrne novo obljubo, ne da bi spremenila stanje prvotne obljube. Obravnavalnik onRejected prejme razlog za zavrnitev, ki ni nujno objekt Error, in se izvede asinhrono, tudi če je bila obljuba že zavrnjena.
Če obravnavalnik vrne običajno vrednost, se nova obljuba izpolni s to vrednostjo; če izpustite return, je rezultat undefined. Če vrne obljubo ali objekt s klicljivo metodo then, nova obljuba prevzame njegov končni rezultat. Če sprožite napako, se nova obljuba zavrne. Če želite napako posredovati naprej, uporabite throw in je ne zgolj izpišite.
Ob izpolnitvi obljube se obravnavalnik preskoči, vrednost pa se posreduje naprej. Če onRejected ni funkcija, se naprej posreduje tudi zavrnitev. catch za then obravnava tudi napake, sprožene v tem prejšnjem koraku, ne pa napak v poznejših korakih ali v neodvisnih asinhronih operacijah, ki niso bile vrnjene.
Primeri
Promise.resolve(10)
.then(() => {
throw new Error("failed");
})
.catch((error) => {
console.log(error.message);
return 42;
})
.then((value) => {
console.log(value);
});
console.log("sync");Rezultat
sync failed 42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.