error TS2538: Type 'undefined' cannot be used as an index type.
Folosești ca cheie (obiect[cheie]) o valoare care poate fi undefined, de exemplu rezultatul lui find() sau un parametru opțional. Verifică întâi că cheia există (if, ??) și abia apoi indexează.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Ca să citești preturi[cheie], cheie trebuie să fie string, number sau symbol. Dacă tipul ei include undefined (de exemplu string | undefined), TypeScript nu poate garanta că accesul are sens: preturi[undefined] ar căuta proprietatea cu numele "undefined".
Sursele obișnuite ale unei chei undefined: Array.find(), care întoarce undefined dacă nu găsește nimic, parametri opționali (cheie?: string), proprietăți opționale, Map.get(), elemente de tablou cu noUncheckedIndexedAccess. Același mesaj apare și cu null: Type 'null' cannot be used as an index type.
Linia din mesaj arată accesul cu paranteze drepte. Treci cu mouse-ul peste cheie și vezi | undefined. Restrânge tipul înainte: if (cheie), if (cheie !== undefined), sau dă o valoare implicită cu ??.
De ce apare: cauzele frecvente
1Cheia vine din find()
const preturi: Record<string, number> = { mere: 5 };
const cheie = ['mere'].find(p => p.startsWith('m'));
preturi[cheie];const preturi: Record<string, number> = { mere: 5 };
const cheie = ['mere'].find(p => p.startsWith('m'));
if (cheie) preturi[cheie];După if, TypeScript știe că cheie e string.
2Parametru opțional folosit ca cheie
function pret(lista: Record<string, number>, produs?: string) {
return lista[produs];
}function pret(lista: Record<string, number>, produs?: string) {
return produs === undefined ? 0 : lista[produs];
}Tratezi explicit cazul în care produsul lipsește.
3Valoare implicită pentru cheie
const tema: string | undefined = undefined;
const culori: Record<string, string> = { alb: '#fff' };
culori[tema];const tema: string | undefined = undefined;
const culori: Record<string, string> = { alb: '#fff' };
culori[tema ?? 'alb'];?? înlocuiește undefined cu o cheie validă.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2538: Type 'undefined' cannot be used as an index type. Repară-l ca să afișeze prețul primului produs care începe cu „p”: pere: 7 lei.
const preturi: Record<string, number> = { mere: 5, pere: 7, prune: 9 };
const ales = Object.keys(preturi).find(p => p.startsWith('p'));
console.log(`${ales}: ${preturi[ales]} lei`);pere: 7 lei
Indiciu
Rezultatul lui find poate lipsi; verifică-l înainte să-l folosești ca cheie.
Reparația
const preturi: Record<string, number> = { mere: 5, pere: 7, prune: 9 };
const ales = Object.keys(preturi).find(p => p.startsWith('p'));
if (ales !== undefined) {
console.log(`${ales}: ${preturi[ales]} lei`);
}De ce merge
find întoarce string | undefined: dacă niciun produs nu se potrivește, rezultatul e undefined. O cheie undefined nu poate indexa un obiect, de aceea TypeScript oprește compilarea. În interiorul lui if (ales !== undefined), tipul e restrâns la string, iar preturi[ales] e valid și dă 7 pentru pere.
Alte forme ale mesajului
error TS2538: Type 'null' cannot be used as an index type.error TS2538: Type 'true' cannot be used as an index type.
Cum o eviți pe viitor
- Când o funcție întoarce
T | undefined(find, get, parametri opționali), verifică rezultatul imediat. - Dă valori implicite parametrilor:
produs = 'standard'în loc deprodus?: string. - Evită operatorul
!pentru a „repara” rapid: ascunde problema până la rulare. - Activează
noUncheckedIndexedAccessdacă vrei ca TypeScript să te avertizeze și la accesul în tablouri și dicționare.
Întrebări frecvente
Ce se întâmplă la rulare dacă forțez?
obiect[undefined] caută proprietatea "undefined" și întoarce aproape sigur undefined, iar codul continuă cu o valoare greșită. TypeScript te oprește ca să decizi ce faci când cheia lipsește.
E la fel cu TS7053?
Nu. TS7053 apare când cheia e de tip string, dar obiectul are doar chei fixe. TS2538 apare când cheia poate fi undefined sau null, adică nu e deloc o cheie validă.
Erori înrudite
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 TS18048: 'produs' is possibly 'undefined'. Variabila poate fi undefined (rezultat de la find(), Map.get(), un câmp opțional), iar tu o folosești ca și cum ar avea mereu valoare. Verifică înainte (if (produs)), folosește ?. și ?? pentru o valoare implicită, sau tratează explicit cazul lipsă. error TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string'. Trimiți unei funcții o valoare care poate fi undefined (câmp opțional, find(), Map.get()), dar parametrul acceptă doar string. Verifică valoarea înainte de apel, dă-i o valoare implicită cu ?? sau, dacă funcția poate trata lipsa, fă parametrul opțional. Î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.
