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.
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
function incarca() {
const date = await Promise.resolve([1, 2]);
return date.length;
}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
async function proceseaza(ids: number[]) {
ids.forEach((id) => {
await Promise.resolve(id);
});
}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
const r = await Promise.resolve(5);
console.log(r);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ă 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.
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);Comanda 42: 3 produse
Indiciu
Funcția care conține await trebuie marcată async.
Reparația
function citesteComanda(id: number): Promise<string[]> {
return Promise.resolve(["carte", "pix", "caiet"]);
}
async function afiseazaComanda(id: number) {
const produse = await citesteComanda(id);
console.log(`Comanda ${id}: ${produse.length} produse`);
}
afiseazaComanda(42);De ce merge
await oprește execuția funcției până când promisiunea se rezolvă, iar asta e posibil doar într-o funcție async. Cu async function afiseazaComanda, await citesteComanda(id) întoarce direct tabloul string[], deci produse.length e 3. Funcția întoarce acum Promise<void>; aici nu avem nevoie de rezultat, așa că apelul simplu afiseazaComanda(42) e suficient.
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ă fieasync. - Evită
forEachcuasync: nu așteaptă promisiunile. Foloseștefor...of(pe rând) sauawait 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
error TS1064: The return type of an async function or method must be the global Promise<T> type. Did you mean to write 'Promise<number>'? O funcție async întoarce întotdeauna un Promise, deci tipul de return nu poate fi number sau string simplu. Scrie Promise<number> (cum îți sugerează mesajul) și folosește await la apel ca să obții valoarea. error TS2355: A function whose declared type is neither 'undefined', 'void', nor 'any' must return a value. Ai declarat tipul de return al funcției (de exemplu : number), dar corpul nu conține niciun return cu valoare. Adaugă return-ul care lipsește sau, dacă funcția doar afișează ceva, schimbă tipul în void. error TS18046: 'e' is of type 'unknown'. Variabila are tipul unknown (des: eroarea din catch, rezultatul lui JSON.parse tipat ca unknown) și nu poți folosi nimic pe ea până nu verifici ce este. Fă narrowing, de exemplu if (e instanceof Error) console.log(e.message). Î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.
