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

error TS2322: Type 'Promise<number>' is not assignable to type 'number'.

Pe scurt

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

Greșit
TypeScript
async function stoc(): Promise<number> { return 5; }
async function main() {
  const n: number = stoc();
}
Corect
TypeScript
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

Greșit
TypeScript
async function nume() { return 'Ana'; }
function saluta(n: string) {}
saluta(nume());
Corect
TypeScript
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

Greșit
TypeScript
async function pret() { return 10; }
function total(): number {
  return pret() * 2;
}
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
async function citesteStoc(): Promise<number> {
  return 12;
}
async function main() {
  const stoc: number = citesteStoc();
  console.log(`Produse în stoc: ${stoc}`);
}
main();
După reparație, programul afișează
Produse în stoc: 12
Indiciu

Funcția citesteStoc e async: valoarea ei trebuie așteptată.

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ă trebuie await.
  • Când apelezi o funcție, verifică dacă e async; dacă da, pune await imediat.
  • Activează în ESLint regulile @typescript-eslint/no-floating-promises și no-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

← 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.