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

error TS2504: Type 'number[]' must have a '[Symbol.asyncIterator]()' method that returns an async iterator.

Pe scurt

Ai folosit for await (const x of valoare) pe ceva ce nu e iterabil: un număr, un obiect simplu sau o Promise care întoarce un tablou. Așteaptă întâi Promise-ul (for (const x of await lista())) sau folosește un tablou ori un generator async.

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

Ce înseamnă

for await (const x of sursa) cere ca sursa să fie iterabilă: fie async (are [Symbol.asyncIterator], ca un generator async function*), fie obișnuită (tablou, Map, Set). Mesajul spune că tipul dat nu are nicio metodă de iterare.

Cea mai frecventă cauză: for await (const p of incarcaProduse()), unde funcția e async și întoarce Promise<Produs[]>. O Promise nu e iterabilă; tabloul din ea e. Corect e for (const p of await incarcaProduse()). Alte cauze: un obiect simplu ({ a: 1 }, folosește Object.values) sau un număr (for await (const i of 5)).

Tipul din mesaj îți spune ce ai dat; dacă vezi Promise<...>, ai nevoie de await înainte.

De ce apare: cauzele frecvente

1for await pe o Promise care întoarce un tablou

Greșit
TypeScript
async function lista(): Promise<string[]> { return ['a']; }
async function main() {
  for await (const x of lista()) {}
}
Corect
TypeScript
async function lista(): Promise<string[]> { return ['a']; }
async function main() {
  for (const x of await lista()) {}
}

await lista() dă tabloul, iar tabloul se parcurge cu un for...of obișnuit.

2for await pe un obiect simplu

Greșit
TypeScript
const stoc = { mere: 2, pere: 3 };
async function main() {
  for await (const v of stoc) {}
}
Corect
TypeScript
const stoc = { mere: 2, pere: 3 };
async function main() {
  for (const v of Object.values(stoc)) {}
}

Obiectele simple nu sunt iterabile; Object.values dă un tablou.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2504: Type 'Promise<string[]>' must have a '[Symbol.asyncIterator]()' method. Funcția async întoarce lista de comenzi. Repară bucla ca programul să afișeze pe rânduri Comanda C1, Comanda C2, Comanda C3.

Codul care dă eroarea
TypeScript
async function comenzi(): Promise<string[]> {
  return ['C1', 'C2', 'C3'];
}
async function main() {
  for await (const c of comenzi()) {
    console.log(`Comanda ${c}`);
  }
}
main();
După reparație, programul afișează
Comanda C1
Comanda C2
Comanda C3
Indiciu

Așteaptă întâi rezultatul funcției, apoi parcurge tabloul cu un for...of obișnuit.

Alte forme ale mesajului

  • error TS2504: Type 'Promise<string[]>' must have a '[Symbol.asyncIterator]()' method that returns an async iterator.
  • error TS2504: Type '{ mere: number; pere: number; }' must have a '[Symbol.asyncIterator]()' method that returns an async iterator.

Cum o eviți pe viitor

  • Folosește for await doar pentru surse care dau valori pe rând, asincron: generatoare async function*, stream-uri, liste de Promise-uri.
  • Pentru o funcție async care întoarce un tablou, scrie for (const x of await f()).
  • Pentru obiecte, parcurge Object.keys, Object.values sau Object.entries.
  • Uită-te la tipul din mesaj: Promise<...> înseamnă că lipsește un await.

Întrebări frecvente

Merge for await pe un tablou obișnuit?

Da, for await acceptă și iterabile obișnuite și așteaptă fiecare element dacă e o Promise. Pentru un tablou de valori simple, însă, for...of e suficient.

Cum fac o sursă pe care s-o pot parcurge cu for await?

Scrie un generator async: async function* pagini() { yield await citeste(1); ... }. Rezultatul are [Symbol.asyncIterator].

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.