Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri