Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes