Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri