error TS2504: Type 'number[]' must have a '[Symbol.asyncIterator]()' method that returns an async iterator.
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
async function lista(): Promise<string[]> { return ['a']; }
async function main() {
for await (const x of lista()) {}
}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
const stoc = { mere: 2, pere: 3 };
async function main() {
for await (const v of stoc) {}
}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ă 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.
async function comenzi(): Promise<string[]> {
return ['C1', 'C2', 'C3'];
}
async function main() {
for await (const c of comenzi()) {
console.log(`Comanda ${c}`);
}
}
main();Comanda C1 Comanda C2 Comanda C3
Indiciu
Așteaptă întâi rezultatul funcției, apoi parcurge tabloul cu un for...of obișnuit.
Reparația
async function comenzi(): Promise<string[]> {
return ['C1', 'C2', 'C3'];
}
async function main() {
for (const c of await comenzi()) {
console.log(`Comanda ${c}`);
}
}
main();De ce merge
comenzi() întoarce o Promise, iar o Promise nu e iterabilă: nu are nici [Symbol.iterator], nici [Symbol.asyncIterator]. Tabloul de comenzi există abia după await. await comenzi() dă string[], pe care îl parcurgi cu for...of, element cu element. for await ar fi potrivit doar pentru o sursă care produce valorile pe rând, de exemplu un generator async.
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 awaitdoar pentru surse care dau valori pe rând, asincron: generatoareasync 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.valuessauObject.entries. - Uită-te la tipul din mesaj:
Promise<...>înseamnă că lipsește unawait.
Î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
error TS2488: Type 'number' must have a '[Symbol.iterator]()' method that returns an iterator. Folosești for...of, spread [...x] sau destructurare [a, b] = x pe ceva care nu e iterabil: un număr sau un obiect simplu. Pentru obiecte folosește Object.entries / Object.values; pentru un număr de pași folosește un for clasic. error TS1103: 'for await' loops are only allowed within async functions and at the top levels of modules. 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. error TS2322: Type 'Promise<number>' is not assignable to type 'number'. Ai pus rezultatul unei funcții async într-o variabilă de tip number fără await. O funcție async întoarce mereu un Promise. Adaugă await (într-o funcție async) sau folosește .then(). Î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.
