CKTIS / JavaScript
async — asinhrone funkcije
async označuje asinhrono funkcijo: njen klic vrne Promise, njeno telo pa lahko uporablja await. Koda se zato ne izvaja samodejno vzporedno ali v ločeni niti.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
async function name(parameters) { /* body */ }
const name = async (parameters) => { /* body */ };async označuje običajno asinhrono funkcijo, metodo ali puščično funkcijo; ta sintaksa je del ECMAScript 2017. Je ključna beseda, vendar ni rezervirana beseda: lahko se uporablja tudi kot ime spremenljivke. Med async in function ne sme biti preloma vrstice; podobna omejitev velja med async in parametri puščične funkcije.
Klic običajne funkcije async vedno vrne nov Promise. Rezultat določa return; vrnjena obljuba se prevzame, namesto da bi nastal ugnezden rezultat. Če return izpustimo, je rezultat undefined, neujeta izjema pa povzroči zavrnitev obljube. Rezultat obravnavaj z await ali .then(), napake pa z try...catch okoli await ali z .catch().
Telo se izvaja sinhrono do prvega await. await začasno ustavi to funkcijo, ne celotnega programa; funkcija se nadaljuje pozneje, tudi če je obljuba že izpolnjena. Sam async ne premakne računanja v ločeno nit: dolga zanka še vedno blokira trenutno nit.
Primer prikazuje vrstni red start, outside, 42. async function* je ločen primer: vrne asinhroni generator, ne neposredno Promise. Ta zapis obravnava sintakso jezika, ne razpoložljivosti Web API-jev; različica Node.js v repozitoriju ne potrjuje podpore API-jev v brskalnikih.
Primeri
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));Rezultat
start outside 42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.