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.