CKTIS / JavaScript
Operátor await — čekání na výsledek
Výraz await pozastaví aktuální vykonávání asynchronní funkce nebo modulu, dokud se očekávaná hodnota nevyřeší. Vrátí hodnotu splnění příslibu, nebo vyvolá důvod jeho zamítnutí, aniž by blokoval celé vlákno.
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
await expressionawait expression vyhodnotí operand a pomocí mechanismu příslibů čeká na jeho výsledek. Při splnění příslibu poskytne výraz await jeho hodnotu; při zamítnutí vyvolá na tomto místě důvod zamítnutí jako výjimku. Lze jej zpracovat pomocí try...catch. Přijímají se také běžné hodnoty a thenable, tedy objekty s volatelnou metodou then.
await pozastaví aktuální vykonávání asynchronní funkce nebo modulu, nikoli celé vlákno. I běžná hodnota nebo již splněný příslib způsobí asynchronní pokračování. Proto se v příkladu objeví outside před 42. Samotné await nepřesouvá výpočet do jiného vlákna.
Používejte jej v těle funkce async (včetně asynchronního generátoru) nebo na nejvyšší úrovni modulu. Běžný skript ani běžná funkce vnořená do funkce async toto oprávnění nezískají. await vyžaduje operand a nesmí se vyskytovat v inicializátorech parametrů asynchronní funkce. Použití jako identifikátoru je podle kontextu omezené; tomuto názvu se vyhněte.
Následující příkazy await mohou nezávislé operace zbytečně serializovat. Chcete-li čekat na několik nezávislých operací společně, nejprve je spusťte a potom použijte await Promise.all(...). Podpora syntaxe await nedokládá dostupnost žádného Web API v daném prostředí.
Příklady
async function main() {
console.log("start");
const value = await Promise.resolve(42);
console.log(value);
}
main().catch(console.error);
console.log("outside");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.