Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Promise.prototype.catch — gestione dei rifiuti

Il metodo catch() associa un gestore del rifiuto a una promise. Permette di recuperare restituendo un valore valido o di propagare un errore e, con il metodo then standard, restituisce una nuova promise.

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

Sintassi

promise.catch(onRejected)

Promise.prototype.catch chiama this.then(undefined, onRejected). Con il metodo then standard, restituisce una nuova promise senza modificare lo stato della promise originale. Il gestore onRejected riceve la causa del rifiuto, che non deve necessariamente essere un oggetto Error, e viene eseguito in modo asincrono anche se la promise era già stata rifiutata.

Restituendo un valore ordinario dal gestore, la nuova promise viene soddisfatta con quel valore; omettendo return si ottiene undefined. Restituendo una promise o un oggetto con un metodo then invocabile, la nuova promise ne adotta l’esito finale. Lanciare un errore rifiuta la nuova promise. Per propagare un errore, usa throw invece di limitarti a visualizzarlo.

Se la promise viene soddisfatta, il gestore viene ignorato e il valore passa oltre. Se onRejected non è una funzione, anche il rifiuto passa oltre. Un catch dopo then gestisce anche gli errori lanciati in quel passaggio precedente, ma non quelli dei passaggi successivi né quelli di operazioni asincrone indipendenti che non sono state restituite.

Esempi

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

Risultato

sync
failed
42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti