TL;DR: Se você quiser seguir as boas práticas, não pode atribuir o valor resolvido de uma Promise
para uma variável que esteja fora do callback
do then
ou catch
ou da função assíncrona. Leia a resposta a seguir para entender o porquê.
O JavaScript é single-threaded[EN] e por isso, opera através de um loop de eventos. Levando essa afirmação em conta, ele não pode esperar que uma Promise
se resolva para continuar a execução do resto da aplicação (diferentemente de linguagens como o PHP), já que isso bloquearia todo o loop de eventos, impedindo outras interações na página.
Levando em conta que uma Promise
irá se concluir em algum momento que não temos ciência (daqui a 5 milissegundos, 5 segundos ou até mesmo mais tempo), não temos como definir o tempo que a promessa ficará "carregando". A forma mais correta de você acessar os dados resolvidos de uma Promise
é através do then
, que receberá o valor resolvido, ou o catch
, que realizará eventuais tratativas de erro.
Tenha ciência, no entanto, que apesar de que você pode sim atribuir o valor resolvido de uma promessa para fora do callback do then
, essa não é uma boa prática (e pode inclusive levar o seu código a erros) justamente pelo fato de que, como disse acima, você não tem como determinar com precisão o tempo em que cada Promise
irá demorar para ser concluída.
Então, seguindo as melhores práticas, para acessar os dados resolvidos de uma Promessa, você tem duas opções:
Utilizar o then
:
app.get('/', (req, res) => {
recuperaDados()
.then((dados) => {
// Você terá que tratar os dados aqui dentro.
// Não poderá passar os dados da variável `dados` para fora
// do escopo desse callback de nenhum modo.
// Note a seguir que eu posso fazer o uso dos dados da forma como eu desejar
// dentro desse callback. Logo, não há motivo para querer levar a variável `dados`
// para fora do escopo atual. :)
res.send('Dados: ' + JSON.stringify(dados))
})
})
Para utilizar função assíncrona, você deve usar o operador await
para aguardar a resolução das funções que retornam Promise
:
// Note abaixo que marquei a função como assíncrona adicionando o prefixo "async".
// ↓↓↓↓↓
app.get('/', async (req, res) => {
// O `await` irá bloquear o código *somente dentro dessa função* até que
// o valor da promessa seja devidamente resolvido:
const dados = await recuperaDados()
// Como utilizamos o `await` acima, esse código só será executado
// quando os dados da promessa estiverem "prontos":
res.send('Dados: ' + JSON.stringify(dados))
})
Lembre-se de que ao usar funções assíncronas, você deve usar o await
para que você aguarda a conclusão da Promise
(resolução ou rejeição), caso contrário, você estará atribuindo à variável a promessa em si, e não o seu valor de resolução ou erro. O operador await
vai parar a execução dentro da função assíncrona até que a Promise
se resolva.
Leitura complementar interessante ou para aprofundamento: