...
Eroare JavaScript · Promisiuni și async/await

SyntaxError: await is only valid in async functions and the top level bodies of modules

Pe scurt

Ai folosit `await` într-o funcție care nu e marcată `async` (des: într-un callback de `forEach` sau `map`) sau la nivelul de sus al unui script care nu e modul. Adaugă `async` funcției care conține `await`, sau pune codul într-o funcție `async function main() { ... }` și apeleaz-o.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

await așteaptă o promisiune fără să blocheze programul, iar asta e posibil doar într-o funcție async sau la nivelul de sus al unui modul ES (<script type="module">, fișiere .mjs). În orice alt loc, motorul refuză codul încă de la citire.

Capcana frecventă: await stă într-o funcție interioară, nu în cea marcată async. De exemplu, async function incarca() { ids.forEach((id) => { await citeste(id); }); }: arrow function-ul din forEach e o funcție separată, fără async.

Chiar dacă adaugi async callback-ului din forEach, acesta nu așteaptă promisiunile, așa că pentru rulare pe rând folosește for...of cu await, iar pentru rulare în paralel await Promise.all(lista.map(async (x) => ...)).

În scripturile clasice (și în editorul nostru), pune codul principal într-o funcție async function main() și apelează main().

De ce apare: cauzele frecvente

1Funcție fără async

Greșit
JavaScript
function incarcaProfil() {
  const user = await citesteUser(1);
  return user.nume;
}
Corect
JavaScript
async function incarcaProfil() {
  const user = await citesteUser(1);
  return user.nume;
}

async îi permite funcției să folosească await; funcția va returna o promisiune.

2await în callback-ul lui forEach

Greșit
JavaScript
async function incarcaToate(ids) {
  ids.forEach((id) => {
    const p = await citeste(id);
    console.log(p);
  });
}
Corect
JavaScript
async function incarcaToate(ids) {
  for (const id of ids) {
    const p = await citeste(id);
    console.log(p);
  }
}

await trebuie să fie în funcția async însăși, nu într-un callback. for...of așteaptă fiecare pas, în ordine.

3await la nivelul de sus al unui script clasic

Greșit
JavaScript
const date = await incarca();
console.log(date);
Corect
JavaScript
async function main() {
  const date = await incarca();
  console.log(date);
}
main();

În scripturile care nu sunt module, await la nivelul de sus nu e permis. O funcție main rezolvă problema.

Repară tu

Repară eroarea, direct în pagină

Funcția afiseazaComenzi de mai jos încarcă pe rând trei comenzi (simulate cu întârziere) și le afișează, dar codul nu pornește: consola arată SyntaxError: await is only valid in async functions and the top level bodies of modules. Repară funcția ca să afișeze comenzile în ordine, apoi Gata.

Codul care dă eroarea
JavaScript
function incarcaComanda(id) {
  return new Promise((resolve) => setTimeout(() => resolve(`Comanda ${id}`), 10));
}

async function afiseazaComenzi(ids) {
  ids.forEach((id) => {
    const comanda = await incarcaComanda(id);
    console.log(comanda);
  });
  console.log("Gata");
}

afiseazaComenzi([101, 102, 103]);
După reparație, programul afișează
Comanda 101
Comanda 102
Comanda 103
Gata
Indiciu

await trebuie să fie direct într-o funcție async. Înlocuiește forEach cu for...of.

Alte forme ale mesajului

  • SyntaxError: await is only valid in async function
  • SyntaxError: Unexpected reserved word
  • SyntaxError: await is a reserved word
  • SyntaxError: Cannot use keyword 'await' outside an async function

Cum o eviți pe viitor

  • Când scrii await, verifică funcția în care se află direct, nu doar pe cea din exterior.
  • Pentru bucle cu await, folosește for...of; pentru paralel, Promise.all cu map.
  • În scripturi, pune tot codul asincron într-o funcție main sau folosește module.
  • Un linter semnalează await în funcții care nu sunt async.

Întrebări frecvente

Dacă pun async pe callback-ul din forEach, merge?

Dispare eroarea, dar forEach nu așteaptă promisiunile: codul de după buclă rulează înainte ca ele să se termine. Folosește for...of sau Promise.all.

În Node primesc „Unexpected reserved word”. E aceeași?

Da, este o formă mai veche a aceluiași mesaj pentru await folosit în afara unei funcții async.

Erori înrudite

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.