Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

async — asynchronní funkce

async označuje asynchronní funkci: její volání vrací Promise a její tělo může používat await. Kód se tím automaticky nespouští paralelně ani v samostatném vlákně.

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

Syntaxe

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

async označuje běžnou asynchronní funkci, metodu nebo šipkovou funkci; tato syntaxe je součástí ECMAScriptu 2017. Jde o klíčové slovo, nikoli však o rezervované slovo: může sloužit také jako název proměnné. Mezi async a function nesmí být konec řádku; obdobné omezení platí mezi async a parametry šipkové funkce.

Volání běžné funkce async vždy vrací nový Promise. Výsledek určuje return; vrácená promise se převezme, místo aby vznikl vnořený výsledek. Pokud return chybí, výsledkem je undefined; nezachycená výjimka způsobí zamítnutí promise. Výsledek zpracuj pomocí await nebo .then() a chyby pomocí try...catch kolem await nebo pomocí .catch().

Tělo se vykonává synchronně až do prvního await. await pozastaví danou funkci, nikoli celý program; funkce pokračuje později, i když je promise už splněná. Samotné async nepřesouvá výpočty do samostatného vlákna: dlouhá smyčka stále blokuje aktuální vlákno.

Příklad ukazuje pořadí start, outside, 42. async function* je samostatný případ: vrací asynchronní generátor, nikoli přímo Promise. Tento záznam se týká syntaxe jazyka, nikoli dostupnosti Web API; verze Node.js v repozitáři nepotvrzuje podporu API v prohlížečích.

Příklady

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

Výsledek

start
outside
42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje