CKTIS / JavaScript
async — funkcje asynchroniczne
async oznacza funkcję asynchroniczną: jej wywołanie zwraca Promise, a w jej ciele można używać await. Nie uruchamia automatycznie kodu równolegle ani w osobnym wątku.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
async function name(parameters) { /* body */ }
const name = async (parameters) => { /* body */ };async oznacza zwykłą funkcję asynchroniczną, metodę lub funkcję strzałkową; ta składnia jest częścią ECMAScript 2017. To słowo kluczowe, ale nie słowo zastrzeżone: może też być nazwą zmiennej. Między async a function nie wolno umieszczać końca wiersza; analogiczne ograniczenie dotyczy async przed parametrami funkcji strzałkowej.
Wywołanie zwykłej funkcji async zawsze zwraca nowy Promise. return określa jego wynik; zwrócona obietnica jest przyswajana, zamiast tworzyć zagnieżdżony wynik. Brak return daje undefined, a nieprzechwycony wyjątek powoduje odrzucenie obietnicy. Obsłuż wynik przez await lub .then() oraz błędy przez try...catch wokół await albo .catch().
Ciało wykonuje się synchronicznie do pierwszego await. await zawiesza daną funkcję, a nie cały program; wznowienie następuje później, nawet dla już spełnionej obietnicy. Samo async nie przenosi obliczeń do osobnego wątku: długa pętla nadal blokuje bieżący wątek.
Przykład pokazuje kolejność start, outside, 42. Funkcja async function* jest odrębnym przypadkiem: zwraca generator asynchroniczny, a nie bezpośrednio Promise. Wpis dotyczy składni języka, nie dostępności Web APIs; wersja Node.js w repozytorium nie potwierdza obsługi API w przeglądarkach.
Przykłady
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));Wynik
start outside 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.