...
Eroare JavaScript · Erori de sintaxă (SyntaxError)

SyntaxError: Async functions can only be declared at the top level or inside a block.

Pe scurt

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

Greșit
JavaScript
if (modTest) async function incarca() {
  return [1, 2];
}
Corect
JavaScript
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

Greșit
JavaScript
if (online) async function salveaza(d) { await trimite(d); }
else async function salveaza(d) { pastreaza(d); }
Corect
JavaScript
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

Greșit
JavaScript
pas1: async function pregateste() {}
Corect
JavaScript
async function pregateste() {}

Etichetele se pun doar în fața buclelor sau a blocurilor, nu în fața declarațiilor de funcții.

Repară tu

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.

Codul care dă eroarea
JavaScript
const modTest = true;

if (modTest) async function incarcaProduse() {
  return ["Mouse", "Cablu"];
}

incarcaProduse().then((lista) => console.log(`Produse: ${lista.join(", ")}`));
După reparație, programul afișează
Produse: Mouse, Cablu
Indiciu

Declară funcția async înainte de if și apeleaz-o în interiorul condiției.

Alte forme ale mesajului

  • SyntaxError: async functions can only be declared at top level or inside a block
  • Uncaught 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 ESLint curly).
  • 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

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