SyntaxError: await is only valid in async functions and the top level bodies of modules
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
function incarcaProfil() {
const user = await citesteUser(1);
return user.nume;
}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
async function incarcaToate(ids) {
ids.forEach((id) => {
const p = await citeste(id);
console.log(p);
});
}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
const date = await incarca();
console.log(date);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ă 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.
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]);Comanda 101 Comanda 102 Comanda 103 Gata
Indiciu
await trebuie să fie direct într-o funcție async. Înlocuiește forEach cu for...of.
Reparația
function incarcaComanda(id) {
return new Promise((resolve) => setTimeout(() => resolve(`Comanda ${id}`), 10));
}
async function afiseazaComenzi(ids) {
for (const id of ids) {
const comanda = await incarcaComanda(id);
console.log(comanda);
}
console.log("Gata");
}
afiseazaComenzi([101, 102, 103]);De ce merge
Funcția exterioară era async, dar await se afla în arrow function-ul dat lui forEach, care este o funcție separată, fără async. Cu for...of, await se află direct în afiseazaComenzi: fiecare comandă e așteptată înainte de următoarea, iar Gata apare abia la final. Dacă ai fi adăugat doar async pe callback, Gata s-ar fi afișat primul, pentru că forEach nu așteaptă promisiunile.
Alte forme ale mesajului
SyntaxError: await is only valid in async functionSyntaxError: Unexpected reserved wordSyntaxError: await is a reserved wordSyntaxError: 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ștefor...of; pentru paralel,Promise.allcumap. - În scripturi, pune tot codul asincron într-o funcție
mainsau folosește module. - Un linter semnalează
awaitîn funcții care nu suntasync.
Î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
Uncaught (in promise) Error: Request failed O promisiune a fost respinsă (o funcție `async` a aruncat o eroare sau o cerere a eșuat), iar nimeni nu a prins eroarea cu `try...catch` sau `.catch()`. Pune `await` în interiorul unui `try...catch`, sau adaugă `.catch()` la apelul funcției `async`. SyntaxError: Illegal break statement Ai folosit `break` în afara unei bucle sau a unui `switch`, de obicei în callback-ul lui `forEach`, care e o funcție separată, nu o buclă. Folosește `for...of` (unde `break` funcționează) sau metode care se opresc singure: `find`, `some`, `every`. Î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.
