База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници