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.