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

error TS1103: 'for await' loops are only allowed within async functions and at the top levels of modules.

Pe scurt

Ai scris for await (...) într-o funcție care nu e async. Marchează funcția cu async (și atunci ea întoarce un Promise) sau mută bucla la nivelul de sus al unui modul.

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

Ce înseamnă

for await (const x of sursa) parcurge o sursă asincronă (un generator async function*, un stream, o listă de promisiuni) și așteaptă fiecare element. Ca await, are nevoie de un context asincron: o funcție async sau nivelul de sus al unui fișier care e modul (are import sau export).

Mesajul e geamănul lui TS1308 (care e pentru await simplu). Apare când adaugi o buclă for await într-o funcție existentă și uiți să-i pui async, sau într-un callback (forEach, map, handler de eveniment) care nu e asincron.

Linia din mesaj arată bucla. Urcă la cea mai apropiată funcție care o conține (atenție la funcțiile săgeată din interior) și adaugă async. Ține minte că funcția întoarce acum un Promise, deci cine o apelează trebuie s-o aștepte.

De ce apare: cauzele frecvente

1Funcția nu e async

Greșit
TypeScript
async function* pagini() { yield 1; yield 2; }
function citeste() {
  for await (const p of pagini()) console.log(p);
}
Corect
TypeScript
async function* pagini() { yield 1; yield 2; }
async function citeste() {
  for await (const p of pagini()) console.log(p);
}

async creează contextul în care se poate aștepta fiecare element.

2Bucla e într-un callback

Greșit
TypeScript
const surse = [pagini()];
surse.forEach(s => {
  for await (const p of s) {}
});
Corect
TypeScript
for (const s of surse) {
  for await (const p of s) {}
}

Funcția săgeată din forEach e o funcție separată, fără async. Un for...of simplu într-o funcție async evită problema.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1103: 'for await' loops are only allowed within async functions. Repară-l ca să afișeze comenzile, pe rând: Comanda 101, Comanda 102, Comanda 103.

Codul care dă eroarea
TypeScript
async function* comenziNoi() {
  for (const id of [101, 102, 103]) {
    yield id;
  }
}
function proceseaza() {
  for await (const id of comenziNoi()) {
    console.log(`Comanda ${id}`);
  }
}
proceseaza();
După reparație, programul afișează
Comanda 101
Comanda 102
Comanda 103
Indiciu

Funcția care conține bucla trebuie să poată aștepta.

Alte forme ale mesajului

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

Cum o eviți pe viitor

  • Când scrii await sau for await, verifică imediat că funcția care îi conține e async.
  • Evită forEach cu cod asincron: folosește for...of sau for await...of într-o funcție async.
  • Fă din fișiere module (export {}) dacă vrei await la nivelul de sus.

Întrebări frecvente

Pot folosi for await pe un tablou obișnuit?

Da. Dacă tabloul conține promisiuni, for await le așteaptă pe rând. Pentru un tablou de valori simple funcționează și el, dar nu are rost: un for...of simplu e suficient.

Care e diferența față de for...of cu await în interior?

for (const p of lista) { await p } merge pe tablouri de promisiuni. for await funcționează în plus pe iteratori asincroni (generatoare async function*, stream-uri), care nu au Symbol.iterator.

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.