TypeError: Receiver must be an instance of class Cont
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
localStoragesau dintr-un API cuObject.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), undethisdevine 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
const date = JSON.parse(salvat);
const cont = Object.assign(Object.create(Cont.prototype), date);
cont.raport();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
buton.addEventListener("click", cont.raport);buton.addEventListener("click", () => cont.raport());În handler, this e elementul; arrow function-ul păstrează apelul pe cont.
3Metodă împrumutată pe alt obiect
const raport = { titlu: "Lunar", afis: cont.raport };
raport.afis();const raport = { titlu: "Lunar", afis: cont.raport.bind(cont) };
raport.afis();bind fixează this la instanța reală a clasei.
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.
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());Ana: 150 lei
Indiciu
Metoda privată #formateaza există doar pe obiectele create cu new Cont(...).
Reparația
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 date = JSON.parse(salvat);
const cont = new Cont(date.titular, date.sold);
console.log(cont.raport());De ce merge
Object.create(Cont.prototype) dă un obiect care are metodele publice ale clasei, dar constructorul nu rulează, deci obiectul nu primește metoda privată #formateaza. La this.#formateaza(...) motorul verifică dacă obiectul a fost construit de Cont și aruncă eroarea. Cu new Cont(date.titular, date.sold) obiectul e o instanță reală, iar metoda privată funcționează.
Alte forme ale mesajului
TypeError: Receiver must be an instance of class ProdusTypeError: 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ăfromJSONcare foloseștenew). - Când transmiți o metodă ca callback, folosește
() => obiect.metoda()saubind. - Poți declara metodele publice ca arrow functions în câmpuri de clasă (
raport = () => ...) ca să fie mereu legate. - Pentru serializare, scrie
toJSON()șistatic 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
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`. 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ă. TypeError: Object prototype may only be an Object or null: undefined Object.create(x) sau Object.setPrototypeOf(obj, x) a primit ca prototip ceva ce nu e obiect și nici null: de obicei undefined, dintr-un nume greșit sau dintr-o variabilă încă neîncărcată. Verifică valoarea dată ca prototip; pentru un obiect fără prototip, folosește explicit null. Î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.
