CKTIS / JavaScript
Promise.prototype.then — encadenar operaciones asíncronas
Promise.prototype.then registra controladores para la resolución o el rechazo y devuelve una nueva promesa. El resultado del controlador determina cómo continúa la cadena.
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.then(onFulfilled, onRejected)Promise.prototype.then acepta los controladores opcionales onFulfilled y onRejected. El primero recibe el valor de resolución; el segundo, el motivo del rechazo. La llamada devuelve una nueva promesa. Los controladores se ejecutan de forma asíncrona, después de que termina el código síncrono actual, incluso si la promesa original ya está resuelta.
Devolver un valor ordinario resuelve la nueva promesa, mientras que lanzar una excepción la rechaza. Devolver una promesa o un objeto con un método then invocable hace que la nueva promesa adopte su resultado final. Si se omite return, el resultado es undefined. Devuelve las operaciones asíncronas para que la cadena espere a que terminen.
Los argumentos no invocables se tratan como controladores ausentes: el valor de resolución o el motivo del rechazo continúa por la cadena. onRejected no captura una excepción lanzada por onFulfilled en la misma llamada a then; gestiónala en un eslabón posterior. Un retorno normal de onRejected puede recuperar el estado de resolución.
Este es un mecanismo de ECMAScript, no una API Web. El método requiere una promesa real como this; no basta con tener un método then. El ejemplo muestra el tratamiento diferido, la transformación de valores y la recuperación de errores.
Ejemplos
console.log('start');
Promise.resolve(3)
.then(value => value * 2)
.then(value => {
console.log(value);
throw new Error('boom');
})
.then(undefined, error => {
console.log(error.message);
return 9;
})
.then(value => console.log(value));
console.log('end');Resultado
start end 6 boom 9
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.