CKTIS / JavaScript
Promise.prototype.catch — zpracování zamítnutí
Metoda catch() připojí obslužnou funkci pro zamítnutí promise. Umožňuje obnovit běh vrácením úspěšné hodnoty nebo předat chybu dál; se standardní metodou then vrací novou promise.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
promise.catch(onRejected)Promise.prototype.catch volá this.then(undefined, onRejected). Se standardní metodou then vrací novou promise, aniž by změnila stav původní promise. Obslužná funkce onRejected obdrží důvod zamítnutí, který nemusí být objektem Error, a spustí se asynchronně, i když už byla promise zamítnuta.
Vrácením běžné hodnoty z obslužné funkce se nová promise splní touto hodnotou; vynechání return znamená výsledek undefined. Vrácením promise nebo objektu s volatelnou metodou then nová promise převezme jeho konečný výsledek. Vyhození chyby novou promise zamítne. Chcete-li chybu předat dál, použijte throw místo pouhého vypsání.
Při splnění promise se obslužná funkce přeskočí a hodnota se předá dál. Pokud onRejected není funkce, předá se dál i zamítnutí. catch umístěné za then zpracuje také chyby vyhozené v tomto předchozím kroku, nikoli však chyby v pozdějších krocích ani v nezávislých asynchronních operacích, které nebyly vráceny.
Pří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ýsledek
sync failed 42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.