Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Promise.prototype.catch — spracovanie zamietnutí

Metóda catch() pripojí obslužnú funkciu pre zamietnutie promise. Umožňuje obnoviť beh vrátením úspešnej hodnoty alebo odovzdať chybu ďalej; so štandardnou metódou then vracia novú promise.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

promise.catch(onRejected)

Promise.prototype.catch volá this.then(undefined, onRejected). So štandardnou metódou then vracia novú promise bez zmeny stavu pôvodnej promise. Obslužná funkcia onRejected dostane dôvod zamietnutia, ktorý nemusí byť objektom Error, a spustí sa asynchrónne, aj keď už bola promise zamietnutá.

Vrátením bežnej hodnoty z obslužnej funkcie sa nová promise splní touto hodnotou; vynechanie return znamená výsledok undefined. Vrátením promise alebo objektu s volateľnou metódou then nová promise prevezme jeho konečný výsledok. Vyhodenie chyby novú promise zamietne. Ak chcete chybu odovzdať ďalej, použite throw namiesto toho, aby ste ju iba vypísali.

Pri splnení promise sa obslužná funkcia preskočí a hodnota sa odovzdá ďalej. Ak onRejected nie je funkcia, ďalej sa odovzdá aj zamietnutie. catch umiestnené za then spracuje aj chyby vyhodené v tomto predchádzajúcom kroku, nie však chyby v neskorších krokoch ani v nezávislých asynchrónnych operáciách, ktoré neboli vrátené.

Príklady

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

Výsledok

sync
failed
42

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje