Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Operator await — oczekiwanie na wynik

Wyrażenie await wstrzymuje bieżące wykonanie funkcji asynchronicznej lub modułu do rozstrzygnięcia oczekiwanej wartości. Zwraca wartość spełnienia obietnicy albo zgłasza powód jej odrzucenia, nie blokując całego 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

await expression

await expression oblicza operand i oczekuje na jego wynik zgodnie z mechanizmem obietnic. Spełnienie obietnicy daje wartość wyrażenia await; odrzucenie powoduje zgłoszenie jego powodu jako wyjątku w tym miejscu. Można go obsłużyć przez try...catch. Akceptowane są również zwykłe wartości oraz obiekty thenable, czyli obiekty z wywoływalną metodą then.

await zawiesza bieżące wykonanie funkcji asynchronicznej lub modułu, a nie cały wątek. Nawet zwykła wartość albo już spełniona obietnica powoduje asynchroniczne wznowienie. Dlatego w przykładzie outside pojawia się przed 42. Samo await nie przenosi obliczeń do innego wątku.

Używaj go w ciele funkcji async (także generatora asynchronicznego) lub na najwyższym poziomie modułu. Zwykły skrypt ani zwykła funkcja zagnieżdżona w funkcji async nie otrzymują tego uprawnienia. await wymaga operandu i nie może występować w inicjalizatorach parametrów funkcji asynchronicznej. Jako nazwa identyfikatora podlega ograniczeniom zależnym od kontekstu; unikaj takiej nazwy.

Kolejne instrukcje await mogą niepotrzebnie uszeregować niezależne operacje. Aby oczekiwać na kilka niezależnych operacji razem, najpierw je rozpocznij, a następnie użyj await Promise.all(...). Obsługa składni await nie dowodzi dostępności jakiegokolwiek Web API w danym środowisku.

Przykłady

async function main() {
  console.log("start");
  const value = await Promise.resolve(42);
  console.log(value);
}

main().catch(console.error);
console.log("outside");

Wynik

start
outside
42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła