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().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Orice funcție marcată async întoarce un Promise, chiar dacă în interior scrie return 42. Ca să obții valoarea, trebuie să aștepți promisiunea: const n = await calculeaza(). Fără await, variabila primește promisiunea însăși, iar TypeScript observă că Promise<number> nu e același lucru cu number.
Aceeași greșeală apare în mai multe forme: TS2345 când dai promisiunea ca argument unei funcții care așteaptă number, sau TS2339 când citești o proprietate de pe ea (raspuns.nume). În ultimul caz terminalul adaugă și indiciul Did you forget to use 'await'?.
Linia din mesaj arată atribuirea. Uită-te la funcția apelată: dacă e async sau întoarce Promise<...>, adaugă await. await se poate folosi doar în funcții async (sau la nivelul de sus al unui modul).
De ce apare: cauzele frecvente
1Lipsește await
async function stoc(): Promise<number> { return 5; }
async function main() {
const n: number = stoc();
}async function stoc(): Promise<number> { return 5; }
async function main() {
const n: number = await stoc();
}await scoate valoarea din promisiune. Fără el, n ar fi fost obiectul Promise.
2Promisiunea dată ca argument
async function nume() { return 'Ana'; }
function saluta(n: string) {}
saluta(nume());async function nume() { return 'Ana'; }
function saluta(n: string) {}
nume().then(saluta);Dacă nu ești într-o funcție async, folosește .then() ca să primești valoarea când e gata.
3Funcția apelantă nu e async
async function pret() { return 10; }
function total(): number {
return pret() * 2;
}async function pret() { return 10; }
async function total(): Promise<number> {
return (await pret()) * 2;
}Dacă ai nevoie de o valoare asincronă, și funcția care o folosește devine asincronă.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2322: Type 'Promise<number>' is not assignable to type 'number'. Repară-l ca să afișeze Produse în stoc: 12.
async function citesteStoc(): Promise<number> {
return 12;
}
async function main() {
const stoc: number = citesteStoc();
console.log(`Produse în stoc: ${stoc}`);
}
main();Produse în stoc: 12
Indiciu
Funcția citesteStoc e async: valoarea ei trebuie așteptată.
Reparația
async function citesteStoc(): Promise<number> {
return 12;
}
async function main() {
const stoc: number = await citesteStoc();
console.log(`Produse în stoc: ${stoc}`);
}
main();De ce merge
citesteStoc e o funcție async, deci întoarce Promise<number>, nu number. Fără await, variabila stoc ar fi primit promisiunea, iar pe ecran ar fi apărut [object Promise]. await așteaptă terminarea promisiunii și dă valoarea 12. Merge pentru că main e și ea async.
Alte forme ale mesajului
error TS2345: Argument of type 'Promise<string>' is not assignable to parameter of type 'string'.error TS2339: Property 'nume' does not exist on type 'Promise<Produs>'.error TS2322: Type 'Promise<void>' is not assignable to type 'void'.
Cum o eviți pe viitor
- Scrie explicit tipul de retur la funcțiile async:
Promise<number>. Îți amintește de fiecare dată că trebuieawait. - Când apelezi o funcție, verifică dacă e
async; dacă da, puneawaitimediat. - Activează în ESLint regulile
@typescript-eslint/no-floating-promisesșino-misused-promises, care prind promisiunile neașteptate.
Întrebări frecvente
De ce async întoarce Promise chiar dacă scriu return 5?
Așa funcționează async: valoarea din return e împachetată automat într-o promisiune, pentru că funcția poate aștepta lucruri înainte de a termina. Cine o apelează trebuie să aștepte și el.
Pot scăpa de async, ca să nu mai trebuiască await?
Doar dacă funcția nu așteaptă nimic. Dacă în interior folosești await (de exemplu pe fetch), rezultatul e disponibil abia mai târziu și nu poți obține sincron valoarea.
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 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 TS2801: This condition will always return true since this 'Promise<boolean>' is always defined. Pui într-un if rezultatul unei funcții async fără await. O promisiune e un obiect, deci e mereu adevărată în condiție. Scrie if (await esteActiv()) într-o funcție async; TypeScript îți sugerează chiar asta: Did you forget to use 'await'? Î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.
