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

CKTIS / JavaScript

async — funções assíncronas

async indica uma função assíncrona: quando chamada, devolve uma Promise e o seu corpo pode usar await. Não executa automaticamente o código em paralelo nem num thread separado.

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

async function name(parameters) { /* body */ }
const name = async (parameters) => { /* body */ };

async indica uma função, um método ou uma função seta assíncronos comuns; esta sintaxe faz parte do ECMAScript 2017. É uma palavra-chave, mas não uma palavra reservada: também pode ser usada como nome de variável. Não pode existir um terminador de linha entre async e function; aplica-se uma restrição correspondente entre async e os parâmetros de uma função seta.

A chamada de uma função async comum devolve sempre uma nova Promise. return determina o resultado; uma promessa devolvida é assimilada, em vez de criar um resultado aninhado. Se não houver return, o resultado é undefined, e uma exceção não capturada rejeita a promessa. Trata o resultado com await ou .then() e os erros com try...catch em torno de await ou com .catch().

O corpo é executado de forma síncrona até ao primeiro await. await suspende essa função, não o programa inteiro; a execução retoma mais tarde, mesmo que a promessa já tenha sido cumprida. async, por si só, não transfere o cálculo para um thread separado: um ciclo longo continua a bloquear o thread atual.

O exemplo demonstra a ordem start, outside, 42. async function* é um caso distinto: devolve um gerador assíncrono, e não diretamente uma Promise. Esta entrada diz respeito à sintaxe da linguagem, não à disponibilidade de Web APIs; a versão de Node.js do repositório não comprova o suporte das APIs nos browsers.

Exemplos

async function double(value) {
  console.log("start");
  const result = await Promise.resolve(value * 2);
  return result;
}

const pending = double(21);
console.log("outside");
pending.then((value) => console.log(value));

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