SyntaxError: Private field '#sold' must be declared in an enclosing class
Folosești un câmp privat (`this.#sold`) care nu e declarat în corpul clasei, sau îl folosești în afara clasei. Câmpurile private trebuie declarate explicit (`#sold = 0;`) și pot fi accesate doar din metodele aceleiași clase. Adaugă declarația sau folosește o metodă publică.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Câmpurile cu # sunt private: există doar în interiorul clasei care le declară. Spre deosebire de proprietățile obișnuite, nu apar automat la prima atribuire. Trebuie declarate în corpul clasei, de exemplu #sold = 0; sau doar #sold;.
Parserul verifică asta înainte de rulare. Dacă găsește this.#sold (sau obj.#sold) și nicio clasă din jurul acelui cod nu declară #sold, respinge tot fișierul cu Private field '#sold' must be declared in an enclosing class.
Apare în trei situații: ai uitat declarația și ai scris direct this.#sold = sold în constructor; ai scris numele diferit (#Sold față de #sold); sau încerci să citești câmpul din afara clasei (cont.#sold), ceea ce nu e permis niciodată.
De ce apare: cauzele frecvente
1Câmp privat nedeclarat
class Cont {
constructor(sold) {
this.#sold = sold;
}
}class Cont {
#sold;
constructor(sold) {
this.#sold = sold;
}
}Câmpurile private trebuie declarate în corpul clasei înainte să le folosești.
2Acces din afara clasei
class Cont {
#sold = 100;
}
const c = new Cont();
console.log(c.#sold);class Cont {
#sold = 100;
get sold() { return this.#sold; }
}
const c = new Cont();
console.log(c.sold);În afara clasei #sold nu există. Un getter public expune valoarea doar pentru citire.
3Nume diferit între declarație și folosire
class Cos {
#produse = [];
adauga(p) { this.#produs.push(p); }
}class Cos {
#produse = [];
adauga(p) { this.#produse.push(p); }
}#produs și #produse sunt câmpuri diferite; doar primul e declarat.
Repară eroarea, direct în pagină
Clasa Portofel de mai jos ține soldul într-un câmp privat, dar programul nu pornește: SyntaxError: Private field '#sold' must be declared in an enclosing class. Repară clasa ca programul să afișeze Sold: 150 lei.
class Portofel {
constructor(sold) {
this.#sold = sold;
}
depune(suma) {
this.#sold += suma;
}
get sold() {
return this.#sold;
}
}
const p = new Portofel(100);
p.depune(50);
console.log(`Sold: ${p.sold} lei`);Sold: 150 lei
Indiciu
Câmpul privat trebuie declarat în corpul clasei, înainte de constructor.
Reparația
class Portofel {
#sold;
constructor(sold) {
this.#sold = sold;
}
depune(suma) {
this.#sold += suma;
}
get sold() {
return this.#sold;
}
}
const p = new Portofel(100);
p.depune(50);
console.log(`Sold: ${p.sold} lei`);De ce merge
Câmpurile private nu se creează la prima atribuire, cum se întâmplă cu proprietățile publice. Fără linia #sold; în corpul clasei, parserul nu știe de unde vine #sold și respinge fișierul. După declarare, constructorul îi dă valoarea 100, depune adaugă 50, iar getter-ul sold oferă acces doar pentru citire din afara clasei.
Alte forme ale mesajului
SyntaxError: reference to undeclared private field or method #soldSyntaxError: Private field '#sold' must be declared in an enclosing class (at app.js:3:10)
Cum o eviți pe viitor
- Declară toate câmpurile private la începutul clasei, cu o valoare inițială dacă are sens.
- Pentru citire din afară, scrie un getter (
get sold()) sau o metodă. - Lasă editorul să completeze numele câmpurilor private, ca să eviți diferențele de literă.
Întrebări frecvente
De ce this.nume = nume merge fără declarație, iar this.#nume nu?
Proprietățile publice se pot crea oricând prin atribuire. Câmpurile private sunt parte din forma clasei și trebuie cunoscute de la parsare, de aceea cer declarație.
Pot vedea câmpurile private în consolă?
Da, consola din Chrome și Node le afișează la inspectarea obiectului, ca ajutor la depanare. Codul tău însă nu le poate citi din afara clasei.
Erori înrudite
TypeError: Cannot read private member #sold from an object whose class did not declare it O metodă care citește `this.#sold` a rulat pe un obiect care nu e instanță a clasei: o copie făcută cu spread (`{...cont}`), un obiect simplu sau o metodă mutată pe alt obiect. Câmpurile private nu se copiază. Lucrează cu instanța originală sau creează una nouă cu `new`. TypeError: Cannot set property pret of #<Produs> which has only a getter Atribui o valoare unei proprietăți definite doar cu `get`, fără `set`. În strict mode (clase, module) asta aruncă eroare. Adaugă un setter, scrie într-un câmp intern (`#pret` sau `_pret`) sau nu mai atribui proprietății calculate. ReferenceError: pret is not defined Folosești un nume (variabilă sau funcție) pe care JavaScript nu îl găsește nicăieri în locul acela: nu a fost declarat, e scris diferit (literele mari contează) sau a fost declarat în alt bloc ori în altă funcție. Declară-l cu `const`/`let` sau corectează numele. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
