CKTIS / JavaScript
async — асинхронни функции
async обозначава асинхронна функция: извикването ѝ връща Promise, а тялото ѝ може да използва await. Това не изпълнява автоматично кода паралелно или в отделна нишка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
async function name(parameters) { /* body */ }
const name = async (parameters) => { /* body */ };async обозначава обикновена асинхронна функция, метод или стрелкова функция; този синтаксис е част от ECMAScript 2017. Това е ключова дума, но не и резервирана дума: може да се използва и като име на променлива. Не се допуска нов ред между async и function; подобно ограничение важи и между async и параметрите на стрелкова функция.
Извикването на обикновена функция async винаги връща нов Promise. return определя резултата му. Ако return върне друг Promise, новият Promise следва неговия изход: изпълнява се със същата стойност или се отхвърля със същата причина, вместо да съдържа вложен Promise като резултат. Ако липсва return, резултатът е undefined, а необработено изключение отхвърля promise. Обработвай резултата с await или .then(), а грешките — с try...catch около await или с .catch().
Тялото се изпълнява синхронно до първия await. await спира тази функция, а не цялата програма; изпълнението ѝ продължава по-късно, дори ако promise вече е изпълнена. Само по себе си async не премества изчисленията в отделна нишка: дълъг цикъл продължава да блокира текущата нишка.
Примерът показва реда start, outside, 42. async function* е отделен случай: връща асинхронен генератор, а не директно Promise. Този запис разглежда синтаксиса на езика, а не наличността на Web APIs; версията на Node.js в хранилището не доказва поддръжка на API от браузърите.
Примери
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));Резултат
start outside 42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.