error TS2731: Implicit conversion of a 'symbol' to a 'string' will fail at runtime. Consider wrapping this expression in 'String(...)'.
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
const ID = Symbol('id');
console.log(`Cheia: ${ID}`);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
function arata<T>(o: T, k: keyof T) {
console.log(`Câmp: ${k}`);
}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ă 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.
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');nume = Ceai pret = 12
Indiciu
Convertește explicit cheia în text înainte să o pui în mesaj.
Reparația
interface Produs {
nume: string;
pret: number;
}
function camp<T>(o: T, k: keyof T) {
console.log(`${String(k)} = ${o[k]}`);
}
const p: Produs = { nume: 'Ceai', pret: 12 };
camp(p, 'nume');
camp(p, 'pret');De ce merge
keyof T înseamnă orice cheie posibilă, iar în JavaScript cheile pot fi string, number sau symbol. Pus direct într-un template string, un symbol aruncă TypeError la rulare, de aceea TypeScript te oprește. String(k) face conversia explicită și merge pentru orice tip de cheie, iar pentru cheile text dă exact numele câmpului.
Cum o eviți pe viitor
- Când afișezi o cheie de tip
keyof TsauPropertyKey, foloseșteString(cheie). - Dacă funcția lucrează doar cu chei text, restrânge tipul:
K extends stringsauExtract<keyof T, string>. - Pentru simbolurile tale, folosește
s.descriptioncâ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
error TS2365: Operator '>' cannot be applied to types 'string' and 'number'. Compari sau combini două valori de tipuri care nu merg împreună cu acel operator, de exemplu un string cu un număr. Adu ambele valori la același tip înainte: Number(text) > 5 sau text.length > 5. error TS2536: Type 'K' cannot be used to index type 'T'. Folosești un parametru de tip K ca cheie într-un obiect de tip T (o[k]), dar nimic nu garantează că K e o cheie a lui T. Adaugă constrângerea: function get<T, K extends keyof T>(o: T, k: K): T[K]. error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'. Ai apelat o funcție cu un argument de alt tip decât cel declarat la parametru: funcția așteaptă number și primește string. Convertește valoarea înainte de apel (Number(...)) sau verifică dacă ai pus argumentele în ordinea corectă. Î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.
