...
Eroare TypeScript · Generice

error TS2536: Type 'K' cannot be used to index type 'T'.

Pe scurt

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

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

Ce înseamnă

În function citeste<T, K>(o: T, k: K) { return o[k]; }, T și K sunt complet independente: apelantul ar putea alege T = Produs și K = boolean. Indexarea o[k] ar fi atunci fără sens, deci TypeScript o refuză. Mesajul se aplică și în tipuri: type Camp<T, K> = T[K] dă aceeași eroare.

Reparația standard este constrângerea K extends keyof T: keyof T este uniunea numelor de proprietăți ale lui T, deci K poate fi doar una dintre ele. Ca bonus, tipul de întoarcere devine precis: T[K] este tipul exact al proprietății alese (string pentru "nume", number pentru "pret").

Variante ale problemei apar în mapped types și în funcții care primesc cheia ca string; acolo, cheia trebuie la fel restrânsă la keyof T.

De ce apare: cauzele frecvente

1Cheie generică fără constrângere

Greșit
TypeScript
function citeste<T, K>(o: T, k: K) {
  return o[k];
}
Corect
TypeScript
function citeste<T, K extends keyof T>(o: T, k: K): T[K] {
  return o[k];
}

K extends keyof T garantează că k e o cheie validă a lui o.

2Tip derivat fără constrângere

Greșit
TypeScript
type Camp<T, K> = T[K];
Corect
TypeScript
type Camp<T, K extends keyof T> = T[K];

Aceeași regulă se aplică și în definițiile de tipuri.

3Cheie dintr-un alt tip

Greșit
TypeScript
interface Produs { nume: string; pret: number }
type Coloane = "nume" | "stoc";
type V<K extends Coloane> = Produs[K];
Corect
TypeScript
interface Produs { nume: string; pret: number }
type Coloane = "nume" | "pret";
type V<K extends Coloane> = Produs[K];

Toate valorile din Coloane trebuie să fie chei ale lui Produs; "stoc" nu este.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2536: Type 'K' cannot be used to index type 'T'. Adaugă constrângerea potrivită pentru K ca programul să compileze și să afișeze Laptop și apoi 3500.

Codul care dă eroarea
TypeScript
function citeste<T, K>(obiect: T, cheie: K): T[K] {
  return obiect[cheie];
}
const produs = { nume: "Laptop", pret: 3500 };
console.log(citeste(produs, "nume"));
console.log(citeste(produs, "pret"));
După reparație, programul afișează
Laptop
3500
Indiciu

K trebuie să fie una dintre cheile lui T: K extends keyof T.

Alte forme ale mesajului

  • error TS2536: Type 'K' cannot be used to index type 'Produs'.

Cum o eviți pe viitor

  • Când o funcție primește un obiect și numele unei proprietăți, scrie semnătura <T, K extends keyof T>(o: T, k: K): T[K].
  • Evită să primești cheia ca string simplu; folosește keyof T.
  • Pentru liste de coloane, derivă tipul cheilor din obiect (keyof Produs), nu-l scrie de mână.
  • Verifică tipul rezultat trecând cu mouse-ul peste apel: ar trebui să fie tipul exact al câmpului.

Întrebări frecvente

Ce este keyof T?

Uniunea numelor de proprietăți ale lui T. Pentru interface Produs { nume: string; pret: number }, keyof Produs este "nume" | "pret".

Și dacă cheia vine ca string de la utilizator?

Atunci verifici la rulare că e o cheie validă (de exemplu cu o listă de chei permise sau cu k in o) și abia apoi o folosești. Tipul string nu poate fi folosit direct ca keyof T.

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.