Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Promise.prototype.then — encadear operações assíncronas

Promise.prototype.then regista funções de tratamento para a conclusão ou rejeição e devolve uma nova promise. O resultado da função de tratamento determina como a cadeia prossegue.

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

Sintaxe

promise.then(onFulfilled, onRejected)

Promise.prototype.then aceita as funções de tratamento opcionais onFulfilled e onRejected. A primeira recebe o valor da conclusão; a segunda, o motivo da rejeição. A chamada devolve uma nova promise. As funções são executadas de forma assíncrona, depois de terminar o código síncrono atual, mesmo que a promise original já esteja resolvida.

Devolver um valor comum resolve a nova promise, enquanto lançar uma exceção a rejeita. Devolver uma promise ou um objeto com um método then invocável faz com que a nova promise adote o resultado final desse elemento. Se não houver return, o resultado é undefined. Devolve as operações assíncronas para que a cadeia espere por elas.

Os argumentos não invocáveis são tratados como funções de tratamento em falta: o valor da conclusão ou o motivo da rejeição segue para a frente. onRejected não captura uma exceção lançada por onFulfilled na mesma chamada a then; trata-a numa ligação posterior. Um retorno normal de onRejected pode recuperar o estado de conclusão.

Este é um mecanismo ECMAScript, não uma API Web. O método exige uma promise verdadeira como this; ter apenas um método then não é suficiente. O exemplo demonstra o tratamento diferido, a transformação de valores e a recuperação de erros.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes