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

CKTIS / JavaScript

Operador await — aguardar um resultado

Uma expressão await suspende a execução atual de uma função assíncrona ou de um módulo até que o valor aguardado fique resolvido. Produz o valor de cumprimento de uma promessa ou lança o motivo da sua rejeição, sem bloquear todo o thread.

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

await expression

await expression avalia o operando e aguarda o resultado através do mecanismo das promessas. Se a promessa for cumprida, a expressão await fornece o valor de cumprimento; se for rejeitada, lança o motivo da rejeição como exceção nesse ponto. Pode tratá-lo com try...catch. Também são aceites valores comuns e thenables, ou seja, objetos com um método then chamável.

await suspende a execução atual de uma função assíncrona ou de um módulo, não todo o thread. Mesmo um valor comum ou uma promessa já cumprida faz com que a execução seja retomada de forma assíncrona. É por isso que outside aparece antes de 42 no exemplo. await, por si só, não transfere o cálculo para outro thread.

Utilize-o no corpo de uma função async (incluindo um gerador assíncrono) ou no nível superior de um módulo. Um script comum ou uma função comum aninhada numa função async não recebe essa permissão. await requer um operando e não pode ocorrer nos inicializadores de parâmetros de uma função assíncrona. A sua utilização como identificador está sujeita a restrições que dependem do contexto; evite esse nome.

Instruções await consecutivas podem serializar desnecessariamente operações independentes. Para aguardar em conjunto várias operações independentes, inicie-as primeiro e depois utilize await Promise.all(...). O suporte da sintaxe await não comprova a disponibilidade de qualquer API Web no ambiente.

Exemplos

async function main() {
  console.log("start");
  const value = await Promise.resolve(42);
  console.log(value);
}

main().catch(console.error);
console.log("outside");

Resultado

start
outside
42

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