...
Eroare JavaScript · Obiecte și clase

TypeError: Receiver must be an instance of class Cont

Pe scurt

O metodă care folosește o metodă privată (this.#ceva()) a rulat cu un this care nu e creat de clasa respectivă: un obiect refăcut din JSON cu Object.create, un buton (în addEventListener) sau un alt obiect. Creează obiectul cu new Clasa(...) și leagă metoda cu bind sau o arrow function.

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

Ce înseamnă

Metodele private (#formateaza()) există doar pe obiectele create efectiv de constructorul clasei. Când codul ajunge la this.#formateaza(), motorul verifică dacă this (numit în specificație „receiver”) a fost construit de clasa Cont. Dacă nu, aruncă această TypeError, cu numele clasei în mesaj. Pentru câmpuri private (this.#sold) mesajul e altul: Cannot read private member #sold from an object whose class did not declare it.

Situații reale:

  • obiecte refăcute din localStorage sau dintr-un API cu Object.create(Cont.prototype) / Object.setPrototypeOf: au metodele publice, dar constructorul nu a rulat, deci nu au partea privată;
  • o metodă dată ca handler: buton.addEventListener("click", cont.raport), unde this devine butonul;
  • o metodă copiată pe alt obiect: { raport: cont.raport }.

Urmărește în stivă metoda publică apelată și întreabă-te ce era this în acel moment.

De ce apare: cauzele frecvente

1Obiect refăcut din JSON fără constructor

Greșit
JavaScript
const date = JSON.parse(salvat);
const cont = Object.assign(Object.create(Cont.prototype), date);
cont.raport();
Corect
JavaScript
const date = JSON.parse(salvat);
const cont = new Cont(date.titular, date.sold);
cont.raport();

Doar new rulează constructorul, care atașează partea privată a obiectului.

2Metodă dată ca handler de eveniment

Greșit
JavaScript
buton.addEventListener("click", cont.raport);
Corect
JavaScript
buton.addEventListener("click", () => cont.raport());

În handler, this e elementul; arrow function-ul păstrează apelul pe cont.

3Metodă împrumutată pe alt obiect

Greșit
JavaScript
const raport = { titlu: "Lunar", afis: cont.raport };
raport.afis();
Corect
JavaScript
const raport = { titlu: "Lunar", afis: cont.raport.bind(cont) };
raport.afis();

bind fixează this la instanța reală a clasei.

Repară tu

Repară eroarea, direct în pagină

Programul salvează un cont ca JSON și îl reface cu Object.create(Cont.prototype), dar cont.raport() aruncă TypeError: Receiver must be an instance of class Cont. Repară refacerea contului ca programul să afișeze Ana: 150 lei.

Codul care dă eroarea
JavaScript
class Cont {
  constructor(titular, sold) {
    this.titular = titular;
    this.sold = sold;
  }

  #formateaza(suma) {
    return `${suma} lei`;
  }

  raport() {
    return `${this.titular}: ${this.#formateaza(this.sold)}`;
  }
}

const salvat = JSON.stringify(new Cont("Ana", 150));

const cont = Object.assign(Object.create(Cont.prototype), JSON.parse(salvat));
console.log(cont.raport());
După reparație, programul afișează
Ana: 150 lei
Indiciu

Metoda privată #formateaza există doar pe obiectele create cu new Cont(...).

Alte forme ale mesajului

  • TypeError: Receiver must be an instance of class Produs
  • TypeError: can't access private field or method: object is not the right class

Cum o eviți pe viitor

  • Creează instanțele doar cu new (sau cu o metodă statică fromJSON care folosește new).
  • Când transmiți o metodă ca callback, folosește () => obiect.metoda() sau bind.
  • Poți declara metodele publice ca arrow functions în câmpuri de clasă (raport = () => ...) ca să fie mereu legate.
  • Pentru serializare, scrie toJSON() și static fromJSON(date) în clasă.

Întrebări frecvente

De ce metodele publice merg pe obiectul refăcut, dar cele private nu?

Metodele publice stau pe prototip, deci orice obiect cu Cont.prototype le are. Partea privată se atașează doar când constructorul rulează, pe obiectul creat cu new.

E aceeași eroare cu „Cannot read private member”?

E aceeași cauză, cu alt mesaj: „Receiver must be an instance” apare la metodele private, „Cannot read private member” la câmpurile private.

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.