CKTIS / JavaScript
Promise.prototype.catch — gestión de rechazos
El método catch() añade un controlador de rechazo a una promesa. Permite recuperarse con un valor satisfactorio o propagar un fallo y, con el método then estándar, devuelve una nueva promesa.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
promise.catch(onRejected)Promise.prototype.catch llama a this.then(undefined, onRejected). Con el método then estándar, devuelve una nueva promesa sin cambiar el estado de la promesa original. El controlador onRejected recibe el motivo del rechazo, que no tiene por qué ser un objeto Error, y se ejecuta de forma asíncrona incluso si la promesa ya estaba rechazada.
Devolver un valor normal desde el controlador cumple la nueva promesa con ese valor; omitir return produce undefined. Devolver una promesa o un objeto con un método then invocable hace que la nueva promesa adopte su resultado final. Lanzar un error rechaza la nueva promesa. Para propagar un fallo, usa throw en lugar de limitarte a mostrarlo.
Si la promesa se cumple, se omite el controlador y se pasa el valor. Si onRejected no es una función, el rechazo también se propaga. Un catch situado después de then también gestiona los errores lanzados en ese paso anterior, pero no los de pasos posteriores ni los de operaciones asíncronas independientes que no se hayan devuelto.
Ejemplos
Promise.resolve(10)
.then(() => {
throw new Error("failed");
})
.catch((error) => {
console.log(error.message);
return 42;
})
.then((value) => {
console.log(value);
});
console.log("sync");Resultado
sync failed 42
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.