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

error TS2538: Type 'undefined' cannot be used as an index type.

Pe scurt

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()

Greșit
TypeScript
const preturi: Record<string, number> = { mere: 5 };
const cheie = ['mere'].find(p => p.startsWith('m'));
preturi[cheie];
Corect
TypeScript
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

Greșit
TypeScript
function pret(lista: Record<string, number>, produs?: string) {
  return lista[produs];
}
Corect
TypeScript
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

Greșit
TypeScript
const tema: string | undefined = undefined;
const culori: Record<string, string> = { alb: '#fff' };
culori[tema];
Corect
TypeScript
const tema: string | undefined = undefined;
const culori: Record<string, string> = { alb: '#fff' };
culori[tema ?? 'alb'];

?? înlocuiește undefined cu o cheie validă.

Repară tu

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.

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

Rezultatul lui find poate lipsi; verifică-l înainte să-l folosești ca cheie.

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 de produs?: string.
  • Evită operatorul ! pentru a „repara” rapid: ascunde problema până la rulare.
  • Activează noUncheckedIndexedAccess dacă 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

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