...
Eroare TypeScript · Obiecte, interfețe și proprietăți

error TS1337: An index signature parameter type cannot be a literal type or generic type. Consider using a mapped object type instead.

Pe scurt

Ai scris [k: Culoare]: number, unde Culoare e o uniune de texte ('rosu' | 'verde'). Index signature acceptă doar string, number, symbol sau template literal. Folosește Record<Culoare, number> sau { [k in Culoare]: number }.

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

Ce înseamnă

O index signature ([k: string]: number) descrie un obiect cu orice chei de un anumit tip larg: string, number, symbol sau un template literal (` id_${string} ). Nu poate fi folosită pentru o listă fixă de chei, cum e o uniune de literale ('rosu' | 'verde') sau un parametru generic K`.

Pentru asta există mapped types: { [k in Culoare]: number }, sau prescurtarea Record<Culoare, number>. Diferența e un singur cuvânt (in în loc de :), dar sensul e altul: mapped type creează câte o proprietate pentru fiecare valoare din uniune și le face obligatorii.

Mesajul sugerează chiar asta: Consider using a mapped object type instead. Linia arată index signature-ul. Dacă unele chei pot lipsi, folosește Partial<Record<Culoare, number>>.

De ce apare: cauzele frecvente

1Uniune de literale ca tip de cheie

Greșit
TypeScript
type Marime = 'S' | 'M' | 'L';
interface Stoc {
  [m: Marime]: number;
}
Corect
TypeScript
type Marime = 'S' | 'M' | 'L';
type Stoc = Record<Marime, number>;

Record creează câte o proprietate pentru fiecare mărime.

2Parametru generic ca tip de cheie

Greșit
TypeScript
type Dictionar<K extends string> = {
  [k: K]: number;
};
Corect
TypeScript
type Dictionar<K extends string> = {
  [k in K]: number;
};

Cu in, e un mapped type, care acceptă generice.

3Unele chei pot lipsi

Greșit
TypeScript
type Zi = 'luni' | 'marti';
interface Program { [z: Zi]: string }
Corect
TypeScript
type Zi = 'luni' | 'marti';
type Program = Partial<Record<Zi, string>>;

Partial face toate cheile opționale.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1337: An index signature parameter type cannot be a literal type or generic type. Repară tipul Stoc ca programul să afișeze S: 4, M: 9, L: 2.

Codul care dă eroarea
TypeScript
type Marime = 'S' | 'M' | 'L';
interface Stoc {
  [m: Marime]: number;
}
const stoc: Stoc = { S: 4, M: 9, L: 2 };
console.log(`S: ${stoc.S}, M: ${stoc.M}, L: ${stoc.L}`);
După reparație, programul afișează
S: 4, M: 9, L: 2
Indiciu

Pentru o listă fixă de chei folosește Record.

Cum o eviți pe viitor

  • Folosește Record<Chei, Valoare> ori de câte ori știi lista de chei.
  • Păstrează index signature ([k: string]: T) pentru obiecte cu chei complet necunoscute.
  • Ține minte diferența: [k: string] = orice cheie; [k in Uniune] = exact cheile din uniune.
  • Dacă unele chei sunt opționale, combină: Partial<Record<Chei, Valoare>>.

Întrebări frecvente

De ce Record e mai bun aici?

Cu Record<Marime, number>, TypeScript verifică că ai pus toate mărimile și că nu ai scris una greșită ('XL'). O index signature cu string ar accepta orice cheie.

Pot folosi un mapped type într-o interface?

Nu. Mapped types se scriu doar cu type. Dacă ai nevoie de interfață, poți extinde un tip: interface Stoc extends Record<Marime, number> {}.

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.