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

error TS2673: Constructor of class 'Config' is private and only accessible within the class declaration.

Pe scurt

Clasa are constructorul private, deci nu poți crea obiecte cu new din afara ei. De obicei e un singleton sau o clasă cu metode fabrică: folosește metoda statică pusă la dispoziție (Config.instanta(), Bani.din(...)) în loc de new.

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

Ce înseamnă

Un constructor private înseamnă că doar codul din interiorul clasei poate apela new. Autorul clasei a ales asta intenționat, ca să controleze cum se creează obiectele. Două tipare frecvente:

  • Singleton: există un singur obiect, obținut printr-o metodă statică (Config.instanta()), care îl creează la prima cerere și apoi îl refolosește.
  • Metode fabrică: obiectele se creează prin funcții statice cu nume clar (Bani.dinLei(12.5), Data.azi()), care validează sau convertesc datele înainte.

Varianta TS2674 apare pentru constructorul protected: poate fi apelat doar din clasă și din subclase, de obicei pentru că e o clasă de bază care nu trebuie instanțiată direct.

Reparația nu e să faci constructorul public, ci să folosești calea oferită de clasă. Caută în ea metodele static.

De ce apare: cauzele frecvente

1Singleton creat cu new

Greșit
TypeScript
class Config {
  private static unic?: Config;
  private constructor() {}
  static instanta() { return (Config.unic ??= new Config()); }
}
const c = new Config();
Corect
TypeScript
class Config {
  private static unic?: Config;
  private constructor() {}
  static instanta() { return (Config.unic ??= new Config()); }
}
const c = Config.instanta();

Metoda statică creează obiectul o singură dată și îl întoarce de fiecare dată.

2Clasă cu metodă fabrică

Greșit
TypeScript
class Bani {
  private constructor(readonly bani: number) {}
  static dinLei(lei: number) { return new Bani(Math.round(lei * 100)); }
}
const b = new Bani(1250);
Corect
TypeScript
class Bani {
  private constructor(readonly bani: number) {}
  static dinLei(lei: number) { return new Bani(Math.round(lei * 100)); }
}
const b = Bani.dinLei(12.5);

Fabrica face conversia corectă; constructorul privat împiedică valorile necontrolate.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2673: Constructor of class 'Jurnal' is private. Clasa e un singleton. Obține obiectul prin metoda statică instanta() în loc de new, ca programul să afișeze 2 mesaje și același obiect: true.

Codul care dă eroarea
TypeScript
class Jurnal {
  private static unic: Jurnal | undefined;
  private mesaje: string[] = [];
  private constructor() {}
  static instanta(): Jurnal {
    if (!Jurnal.unic) {
      Jurnal.unic = new Jurnal();
    }
    return Jurnal.unic;
  }
  scrie(m: string): void {
    this.mesaje.push(m);
  }
  get total(): number {
    return this.mesaje.length;
  }
}
const a = new Jurnal();
const b = new Jurnal();
a.scrie("start");
b.scrie("stop");
console.log(`${a.total} mesaje`);
console.log(`același obiect: ${a === b}`);
După reparație, programul afișează
2 mesaje
același obiect: true
Indiciu

Înlocuiește ambele new Jurnal() cu Jurnal.instanta().

Alte forme ale mesajului

  • error TS2674: Constructor of class 'Forma' is protected and only accessible within the class declaration.

Cum o eviți pe viitor

  • Când primești TS2673, caută în clasă metodele static care creează obiecte.
  • Nu schimba constructorul în public doar ca să treacă codul; ai ocoli regulile clasei.
  • În clasele tale, folosește constructor privat doar când chiar vrei control asupra creării.
  • Documentează metoda fabrică sau singleton-ul, ca alți colegi să știe pe unde se creează obiectele.

Întrebări frecvente

Cum testez o clasă cu constructor privat?

Prin metodele ei publice și fabricile statice, exact cum o folosește restul codului. Dacă testul are nevoie de alte stări, poate că lipsește o metodă fabrică.

Constructorul privat oprește și JavaScript?

Nu. private din TypeScript există doar la compilare. Din JavaScript simplu, new Config() ar funcționa. Restricția protejează codul TypeScript.

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.