Funções assíncronas

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.

A declaração async function define uma função assíncrona, que retorna um objeto AsyncFunction.

Você também pode definir funções assíncronas usando uma expressão async function.

Sintaxe

async function nome([param[, param[, ... param]]]) { instruções }

nome: O nome da função.
param: O nome de um parâmetro a ser passado para a função.
instruções: As instruções que compõem o corpo da função.

Quando uma função assíncrona é chamada, ela retorna uma Promise. Quando a função assíncrona retorna um valor, a Promise será resolvida com o valor retornado. Quando a função assíncrona lança uma exceção ou algum valor, a Promise será rejeitada com o valor lançado.

Uma função assíncrona pode conter uma expressão await, que pausa a execução da função assíncrona e espera pela resolução da Promise passada, e depois retoma a execução da função assíncrona e retorna o valor resolvido.

Nota: A proposta das funções async/await é de simplificar o uso de forma síncrona das Promises e executar alguns procedimentos em um grupo de Promises. Assim como Promises são similares a callbacks estruturados, funções async/await são similares à junção de generators com Promises.

Exemplos

Exemplo simples

function resolverDepoisDe2Segundos(x) { return new Promise((resolve) => { setTimeout(() => { resolve(x); }, 2000); }); } async function adicionar1(x) { var a = resolverDepoisDe2Segundos(20); var b = resolverDepoisDe2Segundos(30); return x + (await a) + (await b); } adicionar1(10).then((v) => { console.log(v); // exibe 60 depois de 2 segundos. }); async function adicionar2(x) { var a = await resolverDepoisDe2Segundos(20); var b = await resolverDepoisDe2Segundos(30); return x + a + b; } adicionar2(10).then((v) => { console.log(v); // exibe 60 depois de 4 segundos. });

Reescrevendo uma cadeia de `Promise` com uma função `async`

Uma API que retorna uma Promise vai resultar em uma cadeia de Promises e separa a função em várias partes. Considere o seguinte código:

function pegarDadosProcessados(url) { return baixarDados(url) // retorna uma Promise .catch((e) => { return baixarDadosReservas(url); // retorna uma Promise }) .then((v) => { return processarDadosNoWorker(v); // retorna uma Promise }); }

pode ser escrita em uma única função async desta forma:

async function pegarDadosProcessados(url) { let v; try { v = await baixarDados(url); } catch (e) { v = await baixarDadosReservas(url); } return processarDadosNoWorker(v); }

Note que no exemplo acima não tem a instrução await na instrução do return, porque o valor retornado de uma função async é implícitamente passado por um Promise.resolve.

Especificações

Specification
ECMAScript® 2026 Language Specification # sec-async-function-definitions

Compatibilidade com navegadores

Notas específicas do Firefox

A função expression closure syntax não é permitida com funções assíncronas e irão lançar a exceção SyntaxError a partir do Firefox 55.