...
Eroare TypeScript · Tipuri de bază, nume și variabile

error TS2731: Implicit conversion of a 'symbol' to a 'string' will fail at runtime. Consider wrapping this expression in 'String(...)'.

Pe scurt

Ai pus un symbol într-un template string sau l-ai lipit cu + la un text. La rulare asta aruncă TypeError: Cannot convert a Symbol value to a string. Folosește String(s) sau s.description, ori verifică întâi că valoarea e text.

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

Ce înseamnă

Un symbol (creat cu Symbol('id')) nu se convertește automat în text: în JavaScript, ` ${s} sau 'id: ' + s aruncă la rulare TypeError: Cannot convert a Symbol value to a string. TypeScript prinde problema dinainte și îți propune soluția: conversia explicită cu String(s), care dă Symbol(id)`.

Cel mai des apare în cod generic care parcurge chei: tipul keyof T sau PropertyKey înseamnă string | number | symbol, iar când pui cheia într-un mesaj, TypeScript nu poate exclude symbol. Mai apare la constante de tip „etichetă” definite cu Symbol.

Reparația: String(cheie) pentru afișare, s.description pentru textul dat la creare, sau restrângi tipul cheii la string (Extract<keyof T, string>, K extends string).

De ce apare: cauzele frecvente

1Symbol în template string

Greșit
TypeScript
const ID = Symbol('id');
console.log(`Cheia: ${ID}`);
Corect
TypeScript
const ID = Symbol('id');
console.log(`Cheia: ${ID.description}`);

Conversia implicită a unui symbol aruncă la rulare. description e textul dat la creare.

2Cheie keyof T afișată direct

Greșit
TypeScript
function arata<T>(o: T, k: keyof T) {
  console.log(`Câmp: ${k}`);
}
Corect
TypeScript
function arata<T>(o: T, k: keyof T) {
  console.log(`Câmp: ${String(k)}`);
}

keyof T poate include symbol, iar un symbol într-un template string aruncă. String(k) funcționează pentru orice tip de cheie.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2731: Implicit conversion of a 'symbol' to a 'string' will fail at runtime. Funcția afișează un câmp ales dintr-un produs. Repar-o, fără să schimbi tipul parametrului, ca programul să afișeze nume = Ceai și pret = 12.

Codul care dă eroarea
TypeScript
interface Produs {
  nume: string;
  pret: number;
}
function camp<T>(o: T, k: keyof T) {
  console.log(`${k} = ${o[k]}`);
}
const p: Produs = { nume: 'Ceai', pret: 12 };
camp(p, 'nume');
camp(p, 'pret');
După reparație, programul afișează
nume = Ceai
pret = 12
Indiciu

Convertește explicit cheia în text înainte să o pui în mesaj.

Cum o eviți pe viitor

  • Când afișezi o cheie de tip keyof T sau PropertyKey, folosește String(cheie).
  • Dacă funcția lucrează doar cu chei text, restrânge tipul: K extends string sau Extract<keyof T, string>.
  • Pentru simbolurile tale, folosește s.description când ai nevoie de nume.
  • Nu ignora mesajul cu as any: la rulare codul chiar aruncă.

Întrebări frecvente

Dar console.log(simbol) merge?

Da, console.log(s) afișează Symbol(id) fără eroare, pentru că nu face o conversie în text, ci afișează valoarea. Problema apare doar la concatenare și în template strings.

Care e diferența dintre String(s) și s.toString()?

Ambele dau Symbol(id). String(s) merge și pentru valori de alt tip (number, string), deci e mai potrivit când tipul e o uniune.

Erori înrudite

← Toate erorile TypeScript

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ță TypeScript de la zero, cu exerciții la fiecare lecție

Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.