...
Eroare TypeScript · Funcții, apeluri și async

error TS1308: 'await' expressions are only allowed within async functions and at the top levels of modules.

Pe scurt

Ai folosit await într-o funcție care nu e marcată async. Adaugă async în fața funcției (async function f() sau async () => ...) și ține minte că acum funcția întoarce un Promise.

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

Ce înseamnă

await are voie să apară doar în două locuri: într-o funcție declarată async sau la nivelul de sus al unui fișier care e modul ES (cu import/export și module setat corespunzător). Oriunde altundeva, TypeScript dă TS1308.

Cel mai des se întâmplă în callback-uri: ai o funcție async, dar în ea un forEach((x) => { await ... }) sau un map(...) cu o funcție-săgeată obișnuită. await-ul aparține funcției celei mai apropiate, adică săgeții, nu funcției exterioare.

Repari marcând async exact funcția în care e scris await. Atenție la consecință: o funcție async întoarce întotdeauna un Promise, deci cine o apelează trebuie fie să folosească la rândul lui await, fie .then(). În editorul nostru nu există await la nivelul de sus: scrii async function main() { ... } și apelezi main();.

De ce apare: cauzele frecvente

1Funcția nu e marcată async

Greșit
TypeScript
function incarca() {
  const date = await Promise.resolve([1, 2]);
  return date.length;
}
Corect
TypeScript
async function incarca() {
  const date = await Promise.resolve([1, 2]);
  return date.length;
}

async permite await în corp; funcția întoarce acum Promise<number>.

2await într-un callback normal

Greșit
TypeScript
async function proceseaza(ids: number[]) {
  ids.forEach((id) => {
    await Promise.resolve(id);
  });
}
Corect
TypeScript
async function proceseaza(ids: number[]) {
  for (const id of ids) {
    await Promise.resolve(id);
  }
}

await aparține săgeții, care nu e async. O buclă for...of păstrează await-ul în funcția async și așteaptă pe rând.

3await la nivelul de sus, în afara unui modul

Greșit
TypeScript
const r = await Promise.resolve(5);
console.log(r);
Corect
TypeScript
async function main() {
  const r = await Promise.resolve(5);
  console.log(r);
}
main();

Aici mesajul e varianta TS1375: un fișier fără import/export nu e modul. Mută codul într-o funcție async și apeleaz-o.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1308: 'await' expressions are only allowed within async functions and at the top levels of modules. Repară funcția afiseazaComanda ca programul să afișeze Comanda 42: 3 produse.

Codul care dă eroarea
TypeScript
function citesteComanda(id: number): Promise<string[]> {
  return Promise.resolve(["carte", "pix", "caiet"]);
}

function afiseazaComanda(id: number) {
  const produse = await citesteComanda(id);
  console.log(`Comanda ${id}: ${produse.length} produse`);
}

afiseazaComanda(42);
După reparație, programul afișează
Comanda 42: 3 produse
Indiciu

Funcția care conține await trebuie marcată async.

Alte forme ale mesajului

  • error TS1375: 'await' expressions are only allowed at the top level of a file when that file is a module, but this file has no imports or exports. Consider adding an empty 'export {}' to make this file a module.

Cum o eviți pe viitor

  • Când scrii await, verifică funcția care îl conține direct: ea trebuie să fie async.
  • Evită forEach cu async: nu așteaptă promisiunile. Folosește for...of (pe rând) sau await Promise.all(lista.map(async (x) => ...)) (în paralel).
  • Pune logica principală într-o funcție async function main().

Întrebări frecvente

De ce forEach(async (x) => ...) compilează, dar nu așteaptă?

Pentru că forEach ignoră valoarea întoarsă de callback, deci promisiunile pornesc toate și nimeni nu le așteaptă. Codul de după forEach rulează înainte să se termine.

Ce înseamnă „at the top levels of modules”?

Că în fișierele modul ES (cu import/export, compilate cu module ES2022 sau mai nou) poți scrie await direct, în afara funcțiilor. Într-un script simplu, ca editorul nostru, nu.

Erori înrudite

← Toate erorile TypeScript

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ță TypeScript de la zero, cu exerciții la fiecare lecție

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