Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje