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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un Symbol e o valoare unică, folosită de obicei ca cheie de proprietate care nu se ciocnește cu altele (Symbol("id"), Symbol.iterator). Ca să nu fie confundate din greșeală cu textele, limbajul interzice conversia implicită a simbolurilor în șir: "id: " + s sau ` ${s} aruncă Cannot convert a Symbol value to a string`.
Conversia explicită e permisă: String(s) dă "Symbol(id)", iar s.description dă "id".
În practică eroarea apare când parcurgi cheile unui obiect cu Reflect.ownKeys sau Object.getOwnPropertySymbols și le afișezi, când o bibliotecă folosește simboluri pe obiectele ei (de exemplu proxy-uri sau ORM-uri) sau când loghezi o valoare necunoscută cu +.
De ce apare: cauzele frecvente
1Simbol concatenat cu un text
const ID = Symbol("id");
console.log("Cheie: " + ID);const ID = Symbol("id");
console.log("Cheie: " + ID.description);description e textul simbolului. Conversia implicită e interzisă, dar accesul la text e direct.
2Afișarea tuturor cheilor unui obiect
const obj = { nume: "Ana", [Symbol("intern")]: 1 };
for (const k of Reflect.ownKeys(obj)) {
console.log(`cheie: ${k}`);
}const obj = { nume: "Ana", [Symbol("intern")]: 1 };
for (const k of Reflect.ownKeys(obj)) {
console.log(`cheie: ${String(k)}`);
}Reflect.ownKeys întoarce și cheile simbol. String(k) funcționează pentru ambele tipuri.
3Logare generică cu +
function log(v) {
console.log("valoare: " + v);
}
log(Symbol.iterator);function log(v) {
console.log("valoare:", v);
}
log(Symbol.iterator);Trimițând valoarea ca argument separat, console.log o afișează fără conversie la text.
Repară eroarea, direct în pagină
Programul de mai jos afișează toate cheile unui obiect, inclusiv una simbol, dar se oprește cu TypeError: Cannot convert a Symbol value to a string. Repară afișarea ca programul să scrie cheie: nume, cheie: rol și cheie: Symbol(versiune).
const VERSIUNE = Symbol("versiune");
const user = { nume: "Ana", rol: "admin", [VERSIUNE]: 3 };
for (const cheie of Reflect.ownKeys(user)) {
console.log("cheie: " + cheie);
}cheie: nume cheie: rol cheie: Symbol(versiune)
Indiciu
Conversia unui simbol în text trebuie cerută explicit, cu String(...).
Reparația
const VERSIUNE = Symbol("versiune");
const user = { nume: "Ana", rol: "admin", [VERSIUNE]: 3 };
for (const cheie of Reflect.ownKeys(user)) {
console.log("cheie: " + String(cheie));
}De ce merge
Reflect.ownKeys întoarce cheile text și cheia simbol. Concatenarea cu + cere o conversie implicită la text, interzisă pentru simboluri. String(cheie) e conversia explicită: pentru texte nu schimbă nimic, iar pentru simbol dă Symbol(versiune).
Alte forme ale mesajului
TypeError: Cannot convert a Symbol value to a numberTypeError: can't convert symbol to stringTypeError: Cannot convert a Symbol value to a string at String.concat
Cum o eviți pe viitor
- Când afișezi valori de tip necunoscut, trimite-le ca argumente separate la
console.logsau foloseșteString(v). - Pentru cheile unui obiect folosește
Object.keys, care întoarce doar chei text, dacă nu ai nevoie de simboluri. - Folosește
simbol.descriptioncând vrei numele din paranteză.
Întrebări frecvente
De ce String(s) merge, iar "" + s nu?
Limbajul permite doar conversia explicită, ca să nu transformi un simbol în text din greșeală (și să pierzi unicitatea lui). String() arată clar că asta vrei.
Apare eroarea și la JSON.stringify?
Nu. JSON.stringify ignoră pur și simplu proprietățile cu chei simbol și valorile de tip simbol, fără eroare.
Erori înrudite
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`. TypeError: Cannot mix BigInt and other types, use explicit conversions Ai combinat un `BigInt` (de exemplu `10n`) cu un `Number` obișnuit într-o operație aritmetică: `10n + 1`. JavaScript nu le amestecă automat. Convertește explicit: `10n + 1n`, `10n + BigInt(x)` sau `Number(big) + 1` (doar dacă valoarea încape sigur într-un Number). TypeError: comenzi is not iterable Folosești `for...of`, spread (`...x`) sau destructurare de tablou pe o valoare care nu poate fi parcursă: un obiect simplu, un număr, `undefined` sau `null`. Pentru obiecte, parcurge `Object.entries(obj)`; pentru `undefined`, află de ce lipsesc datele. Î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.
