...
Eroare JavaScript · Tipuri greșite: funcții, tablouri, iterabile

TypeError: Cannot convert a Symbol value to a string

Pe scurt

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

Greșit
JavaScript
const ID = Symbol("id");
console.log("Cheie: " + ID);
Corect
JavaScript
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

Greșit
JavaScript
const obj = { nume: "Ana", [Symbol("intern")]: 1 };
for (const k of Reflect.ownKeys(obj)) {
  console.log(`cheie: ${k}`);
}
Corect
JavaScript
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 +

Greșit
JavaScript
function log(v) {
  console.log("valoare: " + v);
}
log(Symbol.iterator);
Corect
JavaScript
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ă tu

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).

Codul care dă eroarea
JavaScript
const VERSIUNE = Symbol("versiune");
const user = { nume: "Ana", rol: "admin", [VERSIUNE]: 3 };

for (const cheie of Reflect.ownKeys(user)) {
  console.log("cheie: " + cheie);
}
După reparație, programul afișează
cheie: nume
cheie: rol
cheie: Symbol(versiune)
Indiciu

Conversia unui simbol în text trebuie cerută explicit, cu String(...).

Alte forme ale mesajului

  • TypeError: Cannot convert a Symbol value to a number
  • TypeError: can't convert symbol to string
  • TypeError: 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.log sau folosește String(v).
  • Pentru cheile unui obiect folosește Object.keys, care întoarce doar chei text, dacă nu ai nevoie de simboluri.
  • Folosește simbol.description câ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

← 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.