...
Eroare TypeScript · Clase și interfețe implementate

error TS2341: Property 'sold' is private and only accessible within class 'Cont'.

Pe scurt

Accesezi din afara clasei un câmp sau o metodă marcată private. Folosește metodele publice ale clasei (de exemplu un getter getSold() sau get sold()), sau, dacă accesul extern e chiar necesar, schimbă vizibilitatea în public.

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

Ce înseamnă

private înseamnă că membrul poate fi folosit doar din interiorul clasei care îl declară, adică din metodele ei. Orice obiect.sold scris în afara clasei (sau într-o subclasă) dă TS2341. Mesajul îți spune și clasa care deține membrul.

Câmpurile sunt făcute private intenționat: soldul unui cont nu trebuie modificat direct, ci doar prin depune() și retrage(), care verifică regulile. Așa că reparația corectă e de obicei să folosești interfața publică a clasei, nu să scoți private.

Ca să permiți citirea fără modificare, adaugi un getter: get sold() { return this._sold; } sau o metodă getSold(). Pentru subclase, folosești protected (accesibil în clasă și în cele derivate), iar dacă accesezi un membru protected din exterior primești varianta TS2445.

De ce apare: cauzele frecvente

1Modifici direct un câmp privat

Greșit
TypeScript
class Cont {
  private sold = 0;
  depune(suma: number) { this.sold += suma; }
}
const c = new Cont();
c.sold = 1000;
Corect
TypeScript
class Cont {
  private sold = 0;
  depune(suma: number) { this.sold += suma; }
}
const c = new Cont();
c.depune(1000);

Modificarea trece prin metoda publică, care poate aplica reguli (sumă pozitivă, limite).

2Vrei doar să citești valoarea

Greșit
TypeScript
class Cont {
  private sold = 50;
}
console.log(new Cont().sold);
Corect
TypeScript
class Cont {
  private _sold = 50;
  get sold(): number { return this._sold; }
}
console.log(new Cont().sold);

Un getter fără setter permite citirea, dar nu și atribuirea.

3Subclasa are nevoie de câmp

Greșit
TypeScript
class Angajat {
  private salariu = 5000;
}
class Manager extends Angajat {
  bonus() { return this.salariu * 0.1; }
}
Corect
TypeScript
class Angajat {
  protected salariu = 5000;
}
class Manager extends Angajat {
  bonus() { return this.salariu * 0.1; }
}

protected e vizibil în clasă și în subclase, dar tot ascuns din exterior.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2341: Property 'puncte' is private and only accessible within class 'CardFidelitate'. Nu schimba private: adaugă o metodă publică getPuncte() și folosește-o la afișare, ca programul să afișeze Puncte acumulate: 35.

Codul care dă eroarea
TypeScript
class CardFidelitate {
  private puncte = 0;
  cumparatura(suma: number): void {
    this.puncte += Math.floor(suma / 10);
  }
}
const card = new CardFidelitate();
card.cumparatura(120);
card.cumparatura(230);
console.log(`Puncte acumulate: ${card.puncte}`);
După reparație, programul afișează
Puncte acumulate: 35
Indiciu

Metoda publică întoarce this.puncte; afișarea o apelează în locul câmpului.

Alte forme ale mesajului

  • error TS2445: Property 'salariu' is protected and only accessible within class 'Angajat' and its subclasses.

Cum o eviți pe viitor

  • Expune comportament (metode), nu câmpuri: cont.retrage(100) în loc de cont.sold -= 100.
  • Folosește getteri pentru valorile care trebuie citite din exterior.
  • Alege protected doar când subclasele chiar au nevoie de acces.
  • Nu scoate private doar ca să scapi de eroare: întreabă-te întâi de ce a fost pus.

Întrebări frecvente

private protejează câmpul și la rulare?

Nu. private din TypeScript dispare la compilare. Pentru câmpuri cu adevărat private la rulare folosești sintaxa JavaScript #sold, care dă și o eroare diferită: „Property '#sold' is not accessible outside class 'Cont' because it has a private identifier”.

Care e diferența între TS2341 și TS2445?

TS2341 e pentru private (doar clasa însăși). TS2445 e pentru protected accesat din afara clasei și a subclaselor.

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.