error TS1337: An index signature parameter type cannot be a literal type or generic type. Consider using a mapped object type instead.
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
type Marime = 'S' | 'M' | 'L';
interface Stoc {
[m: Marime]: number;
}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
type Dictionar<K extends string> = {
[k: K]: number;
};type Dictionar<K extends string> = {
[k in K]: number;
};Cu in, e un mapped type, care acceptă generice.
3Unele chei pot lipsi
type Zi = 'luni' | 'marti';
interface Program { [z: Zi]: string }type Zi = 'luni' | 'marti';
type Program = Partial<Record<Zi, string>>;Partial face toate cheile opționale.
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.
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}`);S: 4, M: 9, L: 2
Indiciu
Pentru o listă fixă de chei folosește Record.
Reparația
type Marime = 'S' | 'M' | 'L';
type Stoc = Record<Marime, number>;
const stoc: Stoc = { S: 4, M: 9, L: 2 };
console.log(`S: ${stoc.S}, M: ${stoc.M}, L: ${stoc.L}`);De ce merge
O index signature acceptă doar tipuri largi de chei, cum e string, nu o listă fixă precum 'S' | 'M' | 'L'. Record<Marime, number> e un mapped type: creează câte o proprietate number pentru fiecare mărime, toate obligatorii. Obiectul are exact cele trei chei, deci tipul se potrivește, iar stoc.S, stoc.M și stoc.L sunt numere.
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
error TS2411: Property 'nume' of type 'string' is not assignable to 'string' index type 'number'. Tipul are o index signature ([cheie: string]: number) care spune că toate proprietățile sunt number, dar ai adăugat o proprietate cu alt tip. Lărgește index signature (number | string) sau mută valorile dinamice într-o proprietate separată. error TS7053: Element implicitly has an 'any' type because expression of type 'string' can't be used to index type '{ mere: number; pere: number; }'. Accesezi un obiect cu paranteze drepte și o cheie de tip string oarecare, dar obiectul are doar câteva chei cunoscute. Restrânge cheia la keyof typeof obiect, sau tipează obiectul ca Record<string, number> dacă are chei dinamice. error TS2741: Property 'pret' is missing in type '{ nume: string; }' but required in type 'Produs'. Obiectul pe care îl atribui unui tip (aici Produs) nu are un câmp obligatoriu: lipsește pret. Adaugă câmpul în obiect sau, dacă poate lipsi cu adevărat, marchează-l opțional în interfață (pret?: number). Î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.
