SyntaxError: Async functions can only be declared at the top level or inside a block.
Ai declarat o funcție async direct ca ramură a unui if (sau după o etichetă), fără acolade. Declarațiile async function trebuie să stea la nivelul de sus al fișierului / funcției sau într-un bloc { }. Mut-o afară din if sau folosește o expresie: const f = async () => ...
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Corpul unui if fără acolade poate fi o singură instrucțiune, dar nu orice declarație. Pentru funcțiile obișnuite, browserele acceptă din motive istorice if (x) function f() {} în modul non-strict. Pentru funcțiile async (și generatoare) excepția nu există: if (debug) async function incarca() {} dă Async functions can only be declared at the top level or inside a block. Același mesaj apare și la eticheta: async function f() {}.
De obicei intenția era să definești funcția doar în anumite condiții. Soluția corectă e una dintre:
- declari funcția normal, la nivelul de sus, și pui condiția la apel;
- folosești o variabilă:
let incarca = null; if (x) incarca = async () => {...}; - pui acolade în jurul declarației, dar atunci funcția e vizibilă doar în acel bloc.
De ce apare: cauzele frecvente
1Declarație async ca ramură de if
if (modTest) async function incarca() {
return [1, 2];
}async function incarca() {
return [1, 2];
}
if (modTest) incarca().then(console.log);Declari funcția la nivelul de sus și pui condiția acolo unde o apelezi.
2Funcție aleasă în funcție de o condiție
if (online) async function salveaza(d) { await trimite(d); }
else async function salveaza(d) { pastreaza(d); }const salveaza = online
? async (d) => { await trimite(d); }
: async (d) => { pastreaza(d); };O expresie de funcție atribuită unei constante poate fi aleasă cu o condiție, fără probleme de sintaxă.
3Etichetă în fața unei declarații async
pas1: async function pregateste() {}async function pregateste() {}Etichetele se pun doar în fața buclelor sau a blocurilor, nu în fața declarațiilor de funcții.
Repară eroarea, direct în pagină
Programul încarcă lista de produse doar când modTest este activ, dar dă SyntaxError: Async functions can only be declared at the top level or inside a block. Repară codul ca funcția async să fie declarată corect, iar programul să afișeze Produse: Mouse, Cablu.
const modTest = true;
if (modTest) async function incarcaProduse() {
return ["Mouse", "Cablu"];
}
incarcaProduse().then((lista) => console.log(`Produse: ${lista.join(", ")}`));Produse: Mouse, Cablu
Indiciu
Declară funcția async înainte de if și apeleaz-o în interiorul condiției.
Reparația
const modTest = true;
async function incarcaProduse() {
return ["Mouse", "Cablu"];
}
if (modTest) {
incarcaProduse().then((lista) => console.log(`Produse: ${lista.join(", ")}`));
}De ce merge
O declarație async function nu poate fi corpul unui if fără acolade. Declarată la nivelul de sus, funcția există mereu, iar condiția decide doar dacă o apelezi. Funcția întoarce o promisiune, iar .then afișează lista când promisiunea se rezolvă. Acoladele puse la if țin apelul grupat și evită aceeași problemă la modificări ulterioare.
Alte forme ale mesajului
SyntaxError: async functions can only be declared at top level or inside a blockUncaught SyntaxError: Async functions can only be declared at the top level or inside a block.SyntaxError: Generators can only be declared at the top level or inside a block.
Cum o eviți pe viitor
- Pune mereu acolade la
if, chiar și pentru o singură instrucțiune (regula ESLintcurly). - Declară funcțiile la nivelul de sus și decide la apel dacă le folosești.
- Când funcția depinde de o condiție, folosește o expresie de funcție atribuită unei variabile.
Întrebări frecvente
De ce funcția obișnuită merge, iar cea async nu?
Funcțiile obișnuite au o excepție veche, păstrată pentru compatibilitate cu site-uri vechi, doar în modul non-strict. Pentru async și generatoare, care sunt mai noi, excepția nu a fost adăugată.
Dacă pun acolade, pot folosi funcția după if?
Nu în modul strict și în module: o funcție declarată într-un bloc e vizibilă doar în acel bloc. Declar-o afară dacă îți trebuie și după.
Erori înrudite
SyntaxError: In strict mode code, functions can only be declared at top level or inside a block. Ai pus o declarație function direct după if, else sau o buclă, fără acolade: if (admin) function salut() {}. În strict mode o funcție se declară doar la nivelul de sus sau într-un bloc { }. Pune acolade sau, mai bine, atribuie o funcție unei variabile declarate înainte de if. SyntaxError: Lexical declaration cannot appear in a single-statement context Ai scris o declarație `let` direct după un `if`, `else`, `for` sau `while` fără acolade, de exemplu `if (ok) let x = 1;`. Declarațiile cu `let` au nevoie de un bloc. Declară variabila înainte de condiție și doar atribuie-i valoarea, sau pune acolade. 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. Î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.
