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.