Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

async — funzioni asincrone

async indica una funzione asincrona: la sua chiamata restituisce una Promise e il suo corpo può usare await. Non esegue automaticamente il codice in parallelo né su un thread separato.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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

async indica una normale funzione, un metodo o una funzione freccia asincroni; questa sintassi fa parte di ECMAScript 2017. È una parola chiave, ma non una parola riservata: può essere usata anche come nome di variabile. Non è consentito inserire un terminatore di riga tra async e function; una restrizione analoga vale tra async e i parametri di una funzione freccia.

La chiamata di una normale funzione async restituisce sempre una nuova Promise. return ne determina il risultato; una promise restituita viene assimilata, anziché creare un risultato annidato. Se si omette return, il risultato è undefined, mentre un’eccezione non intercettata rifiuta la promise. Gestisci il risultato con await o .then() e gli errori con try...catch attorno a await o con .catch().

Il corpo viene eseguito in modo sincrono fino al primo await. await sospende quella funzione, non l’intero programma; la funzione riprende in seguito, anche se la promise è già stata soddisfatta. async da solo non sposta il calcolo su un thread separato: un ciclo lungo continua a bloccare il thread corrente.

L’esempio mostra l’ordine start, outside, 42. async function* è un caso distinto: restituisce un generatore asincrono, non direttamente una Promise. Questa voce riguarda la sintassi del linguaggio, non la disponibilità delle Web API; la versione di Node.js nel repository non dimostra il supporto delle API nei browser.

Esempi

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));

Risultato

start
outside
42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti