...
Eroare TypeScript · Generice

error TS2862: Type 'T' is generic and can only be indexed for reading.

Pe scurt

Î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

Greșit
TypeScript
function reset<T extends Record<string, number>>(o: T, k: string) {
  o[k] = 0;
}
Corect
TypeScript
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

Greșit
TypeScript
function cuZero<T extends Record<string, number>>(o: T, k: string) {
  o[k] = 0;
  return o;
}
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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}`);
După reparație, programul afișează
Vizite acasa: 3
Indiciu

Funcția nu are nevoie de generic: un dicționar de numere e suficient.

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 valoarea T[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

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