error TS2862: Type 'T' is generic and can only be indexed for reading.
Într-o funcție generică încerci să scrii obj[cheie] = valoare, unde obj are tipul T. TypeScript nu poate garanta că valoarea se potrivește cu orice T posibil. Folosește tipul concret (Record<string, number>) pentru parametru sau întoarce un obiect nou.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când obiect are tipul generic T extends Record<string, number>, citirea obiect[cheie] e sigură: orice T are valori de tip number. Scrierea nu e: T poate fi un tip mai strict, de exemplu { mere: 1 } (un literal) sau un tip cu chei fixe, unde obiect['oricare'] = 0 nu e permis. Pentru că nu știe ce T va fi la apel, TypeScript permite doar citirea.
Mesajul spune exact asta: tipul T e generic și poate fi indexat doar pentru citire. Apare în funcții utilitare care modifică un obiect primit: resetări, contoare, normalizări.
Reparația: dacă funcția doar modifică valori dintr-un dicționar, nu ai nevoie de generic, folosește direct Record<string, number>. Dacă vrei să păstrezi tipul precis, lucrează pe o copie și întoarce un obiect nou, sau restrânge cheia la keyof T și valoarea la T[keyof T].
De ce apare: cauzele frecvente
1Generic inutil pentru un dicționar
function reset<T extends Record<string, number>>(o: T, k: string) {
o[k] = 0;
}function reset(o: Record<string, number>, k: string) {
o[k] = 0;
}Fără generic, o e un dicționar de numere în care poți scrie orice cheie.
2Vrei să păstrezi tipul precis
function cuZero<T extends Record<string, number>>(o: T, k: string) {
o[k] = 0;
return o;
}function cuZero<T extends Record<string, number>>(o: T, k: string) {
return { ...o, [k]: 0 };
}Un obiect nou nu modifică T, deci nu încalcă nicio garanție.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2862: Type 'T' is generic and can only be indexed for reading. Funcția trebuie doar să adune 1 la un contor. Repar-o ca programul să afișeze Vizite acasa: 3.
function creste<T extends Record<string, number>>(contoare: T, pagina: string) {
contoare[pagina] = (contoare[pagina] ?? 0) + 1;
}
const vizite: Record<string, number> = { acasa: 2 };
creste(vizite, 'acasa');
console.log(`Vizite acasa: ${vizite.acasa}`);Vizite acasa: 3
Indiciu
Funcția nu are nevoie de generic: un dicționar de numere e suficient.
Reparația
function creste(contoare: Record<string, number>, pagina: string) {
contoare[pagina] = (contoare[pagina] ?? 0) + 1;
}
const vizite: Record<string, number> = { acasa: 2 };
creste(vizite, 'acasa');
console.log(`Vizite acasa: ${vizite.acasa}`);De ce merge
Cu T extends Record<string, number>, T poate fi un tip mai strict decât un dicționar (de exemplu cu chei fixe), unde scrierea unei chei oarecare nu e permisă. De aceea TypeScript permite doar citirea. Funcția nu are nevoie să păstreze tipul precis, deci un parametru Record<string, number> e corect: acolo orice cheie text poate primi un număr. Contorul crește de la 2 la 3.
Alte forme ale mesajului
error TS2862: Type 'T' is generic and can only be indexed for reading.
Cum o eviți pe viitor
- Nu folosi generice dacă nu ai nevoie să întorci exact tipul primit: un parametru
Record<string, number>e mai simplu. - Preferă funcții care întorc obiecte noi în loc să le modifice pe cele primite.
- Dacă scrii într-un obiect generic, cheia ar trebui să fie
K extends keyof T, iar valoareaT[K].
Întrebări frecvente
De ce citirea merge și scrierea nu?
Orice T care respectă constrângerea are valori number, deci citirea dă mereu un număr. Dar T poate fi mai strict (chei fixe, valori literale), iar o scriere arbitrară l-ar putea strica.
A apărut eroarea după un upgrade. E nouă?
Mesajul TS2862 a fost introdus în TypeScript 5.3. Înainte, unele astfel de scrieri treceau în tăcere sau dădeau un TS2322 mai greu de citit.
Erori înrudite
error TS2322: Type 'string' is not assignable to type 'T'. 'T' could be instantiated with an arbitrary type which could be unrelated to 'string'. O funcție generică promite să întoarcă T, dar tu întorci o valoare concretă (un string, null, {}). Cel care apelează alege T, deci valoarea ta poate să nu fie de acel tip. Întoarce ceva derivat din parametrii de tip T sau schimbă tipul de întoarcere (de exemplu T | undefined). 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 TS2542: Index signature in type 'readonly number[]' only permits reading. Încerci să modifici un element dintr-un tablou readonly (sau dintr-un obiect cu index signature readonly): lista[0] = .... Creează o copie ([...lista]) și modific-o pe aceea, sau construiește un tablou nou cu map. Î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.
