TypeError: Cannot convert object to primitive value
JavaScript a încercat să transforme un obiect în text sau număr (într-un template literal, la `+` sau la comparație), dar obiectul nu are `toString`/`valueOf`, de obicei pentru că e creat cu `Object.create(null)` sau e un obiect de query fără prototip. Afișează un câmp anume sau folosește `JSON.stringify`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când pui un obiect într-un context care cere un primitiv (` ${obj} , "text" + obj, obj > 5, String(obj)), motorul caută metodele Symbol.toPrimitive, toString sau valueOf. Obiectele obișnuite le moștenesc de la Object.prototype, așa că devin "[object Object]". Obiectele fără prototip nu au niciuna, iar conversia aruncă Cannot convert object to primitive value`.
Obiecte fără prototip apar la Object.create(null) (folosit des pentru dicționare), la req.query sau req.body în unele versiuni de Express și biblioteci de parsare, sau când cineva suprascrie toString cu o valoare care nu e funcție.
Chiar și când nu ai eroare, "[object Object]" în pagină înseamnă aceeași greșeală: afișezi obiectul întreg în loc de un câmp.
De ce apare: cauzele frecvente
1Dicționar creat cu Object.create(null) pus într-un text
const stoc = Object.create(null);
stoc.mere = 5;
console.log(`Stoc: ${stoc}`);const stoc = Object.create(null);
stoc.mere = 5;
console.log(`Stoc: ${JSON.stringify(stoc)}`);Obiectul nu are toString. JSON.stringify funcționează și fără prototip.
2Obiect afișat în loc de câmp
const filtre = Object.assign(Object.create(null), { oras: "Iași" });
console.log("Filtru: " + filtre);const filtre = Object.assign(Object.create(null), { oras: "Iași" });
console.log("Filtru: " + filtre.oras);Afișează proprietatea de care ai nevoie, nu obiectul întreg.
3toString suprascris cu o valoare
const produs = { nume: "Cană", toString: "Cană" };
console.log(`${produs}`);const produs = { nume: "Cană", toString() { return this.nume; } };
console.log(`${produs}`);toString trebuie să fie o funcție care returnează un text; altfel conversia nu mai are ce apela.
Repară eroarea, direct în pagină
Programul de mai jos ține stocul într-un dicționar fără prototip și vrea să-l afișeze, dar se oprește cu TypeError: Cannot convert object to primitive value. Repară afișarea ca programul să scrie Stoc: mere=5, pere=3.
const stoc = Object.create(null);
stoc.mere = 5;
stoc.pere = 3;
console.log(`Stoc: ${stoc}`);Stoc: mere=5, pere=3
Indiciu
Object.entries funcționează și pe obiecte fără prototip; din perechile lui poți construi textul.
Reparația
const stoc = Object.create(null);
stoc.mere = 5;
stoc.pere = 3;
const text = Object.entries(stoc).map(([produs, buc]) => `${produs}=${buc}`).join(", ");
console.log(`Stoc: ${text}`);De ce merge
Object.create(null) creează un obiect fără prototip, deci fără toString și valueOf; template literal-ul nu are cum să-l transforme în text. Object.entries(stoc) dă perechile ["mere", 5] și ["pere", 3], din care map face texte mere=5, iar join(", ") le unește. Așa construiești singur textul, în loc să lași motorul să ghicească.
Alte forme ale mesajului
TypeError: can't convert stoc to stringTypeError: can't convert stoc to primitive typeTypeError: No default value
Cum o eviți pe viitor
- Nu pune obiecte întregi în texte: afișează câmpuri anume sau folosește
JSON.stringify(obj)pentru depanare. - Pentru dicționare, preferă
Map, care are metode clare și nu se confundă cu obiectele obișnuite. - Dacă vrei ca obiectele unei clase să se afișeze frumos, definește metoda
toString().
Întrebări frecvente
De ce console.log(obj) merge, dar console.log("" + obj) aruncă?
console.log(obj) inspectează obiectul fără să-l transforme în text. Concatenarea cu + cere conversie la primitiv, iar obiectul fără prototip nu o suportă.
Ce e [object Object]?
Rezultatul conversiei implicite a unui obiect obișnuit în text. Nu e o eroare, dar semnalează aceeași greșeală: afișezi obiectul în loc de o proprietate a lui.
Erori înrudite
TypeError: Cannot convert a Symbol value to a string Ai pus un `Symbol` într-un text cu `+` sau într-un template literal. Simbolurile nu se transformă automat în text. Folosește `String(simbol)`, `simbol.toString()` sau `simbol.description` dacă vrei să-l afișezi. TypeError: Cannot convert undefined or null to object Ai dat `undefined` sau `null` unei funcții care are nevoie de un obiect: `Object.keys`, `Object.values`, `Object.entries`, `Object.assign` sau `for...in` pe ceva care lipsește. Verifică de unde vine valoarea sau folosește un obiect gol ca rezervă: `Object.keys(date ?? {})`. TypeError: Converting circular structure to JSON `JSON.stringify` a dat peste un obiect care se conține pe el însuși, direct sau printr-un lanț (de exemplu un copil cu referință la părinte). JSON nu poate reprezenta cicluri. Serializează doar câmpurile de care ai nevoie, elimină referința înapoi sau folosește un replacer. Î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.
