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.