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.
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
async function* pagini() { yield 1; yield 2; }
function citeste() {
for await (const p of pagini()) console.log(p);
}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
const surse = [pagini()];
surse.forEach(s => {
for await (const p of s) {}
});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ă 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.
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();Comanda 101 Comanda 102 Comanda 103
Indiciu
Funcția care conține bucla trebuie să poată aștepta.
Reparația
async function* comenziNoi() {
for (const id of [101, 102, 103]) {
yield id;
}
}
async function proceseaza() {
for await (const id of comenziNoi()) {
console.log(`Comanda ${id}`);
}
}
proceseaza();De ce merge
comenziNoi e un generator asincron: fiecare valoare vine printr-o promisiune. for await le așteaptă pe rând, dar asta e posibil doar într-o funcție async. Adăugând async la proceseaza, bucla e permisă. Funcția întoarce acum un Promise, iar programul afișează cele trei comenzi înainte să se termine.
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
awaitsaufor await, verifică imediat că funcția care îi conține easync. - Evită
forEachcu cod asincron: foloseștefor...ofsaufor await...ofîntr-o funcție async. - Fă din fișiere module (
export {}) dacă vreiawaitla 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
error TS1308: 'await' expressions are only allowed within async functions and at the top levels of modules. 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. 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(). 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. Î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.
