...
Eroare TypeScript · Obiecte, interfețe și proprietăți

error TS2339: Property 'total' does not exist on type '{}'.

Pe scurt

Ai creat un obiect gol (const o = {}) și încerci să-i adaugi sau să-i citești câmpuri. TypeScript fixează tipul la {} (fără proprietăți). Declară tipul de la început, cu o interfață sau cu Record<string, number>, ori creează obiectul direct cu toate câmpurile.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În JavaScript e obișnuit să pornești cu {} și să adaugi câmpuri pe parcurs. În TypeScript, const raport = {} primește tipul {}: un obiect despre care nu se știe nicio proprietate. Orice raport.total = 5 sau raport.total dă TS2339, pentru că tipul nu se extinde automat după atribuiri.

Tipul '{}' din mesaj e semnalul: obiectul a fost creat gol sau a fost tipat prea larg. Mai apare la JSON.parse tipat greșit, la parametri generici fără constrângere și la Object.create(null).

Ai două direcții: dacă știi câmpurile, scrii o interfață și creezi obiectul complet (sau cu câmpuri opționale). Dacă cheile sunt dinamice (un contor pe categorii, un index pe id), folosești Record<string, number> sau un Map.

De ce apare: cauzele frecvente

1Obiect construit pe bucăți

Greșit
TypeScript
const raport = {};
raport.total = 150;
raport.comenzi = 3;
Corect
TypeScript
interface Raport { total: number; comenzi: number }
const raport: Raport = { total: 150, comenzi: 3 };

Creat dintr-o bucată, cu tipul declarat, obiectul are de la început toate câmpurile.

2Dicționar cu chei dinamice

Greșit
TypeScript
const contor = {};
for (const c of ["a", "b", "a"]) {
  contor[c] = (contor[c] ?? 0) + 1;
}
Corect
TypeScript
const contor: Record<string, number> = {};
for (const c of ["a", "b", "a"]) {
  contor[c] = (contor[c] ?? 0) + 1;
}

Record<string, number> spune că orice cheie string are o valoare numerică. (Varianta greșită dă aici TS7053.)

3Câmpuri care apar mai târziu

Greșit
TypeScript
const setari = {};
if (true) setari.tema = "dark";
Corect
TypeScript
const setari: { tema?: string } = {};
if (true) setari.tema = "dark";

Un câmp opțional (?) poate lipsi la creare și fi setat ulterior.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2339: Property 'mere' does not exist on type '{}', pentru că obiectul stoc e creat gol și fără tip. Declară tipul lui ca dicționar de la nume de produs la cantitate, ca programul să afișeze mere: 12, pere: 5.

Codul care dă eroarea
TypeScript
const stoc = {};
stoc.mere = 12;
stoc.pere = 5;
console.log(`mere: ${stoc.mere}, pere: ${stoc.pere}`);
După reparație, programul afișează
mere: 12, pere: 5
Indiciu

Folosește Record<string, number> ca tip pentru stoc.

Cum o eviți pe viitor

  • Nu porni cu {} gol fără tip: declară interfața sau Record din prima linie.
  • Pentru numărări și grupări pe chei, folosește Record<string, number> sau Map<string, number>.
  • Când rezultatul se construiește treptat, adună valorile în variabile și creează obiectul la final, dintr-o bucată.

Întrebări frecvente

De ce let o: any = {} merge?

Pentru că any dezactivează verificările. Merge, dar pierzi autocomplete-ul și protecția la greșeli de nume; un tip precis e aproape la fel de scurt.

Ce înseamnă tipul {} exact?

„Orice valoare care nu e null sau undefined”, fără proprietăți cunoscute. Nu e „un obiect gol pe care îl completezi”, ci un tip aproape fără informație.

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.