...
Eroare JavaScript · Obiecte și clase

SyntaxError: Private field '#sold' must be declared in an enclosing class

Pe scurt

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

Greșit
JavaScript
class Cont {
  constructor(sold) {
    this.#sold = sold;
  }
}
Corect
JavaScript
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

Greșit
JavaScript
class Cont {
  #sold = 100;
}
const c = new Cont();
console.log(c.#sold);
Corect
JavaScript
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

Greșit
JavaScript
class Cos {
  #produse = [];
  adauga(p) { this.#produs.push(p); }
}
Corect
JavaScript
class Cos {
  #produse = [];
  adauga(p) { this.#produse.push(p); }
}

#produs și #produse sunt câmpuri diferite; doar primul e declarat.

Repară tu

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.

Codul care dă eroarea
JavaScript
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`);
După reparație, programul afișează
Sold: 150 lei
Indiciu

Câmpul privat trebuie declarat în corpul clasei, înainte de constructor.

Alte forme ale mesajului

  • SyntaxError: reference to undeclared private field or method #sold
  • SyntaxError: 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

← Toate erorile JavaScript

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ță 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.