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 expressionawait 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.