...
Eroare TypeScript · Namespace-uri, enum-uri și tipuri imbricate

error TS2475: 'const' enums can only be used in property or index access expressions or the right hand side of an import declaration or export assignment or type query.

Pe scurt

Un const enum dispare la compilare: fiecare Culoare.Rosu e înlocuit direct cu valoarea. De aceea nu-l poți folosi ca obiect (Object.values(Culoare), for...in, trimis ca argument). Folosește un enum obișnuit sau un obiect as const dacă ai nevoie de lista valorilor.

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

Ce înseamnă

Un enum obișnuit devine la rulare un obiect JavaScript. Un const enum nu: compilatorul înlocuiește fiecare utilizare (Status.Activ) cu valoarea ei (0 sau 'activ') și nu generează niciun obiect. Prin urmare, poți scrie doar accesări de membri (Status.Activ, Status['Activ']), nu și operații care au nevoie de obiectul întreg.

Mesajul apare la Object.values(Status), Object.keys(Status), for (const k in Status), la trimiterea enum-ului ca argument (afiseaza(Status)) sau la atribuirea lui într-o variabilă.

Reparația: dacă ai nevoie de lista valorilor, scoate const și folosește un enum obișnuit, sau, varianta tot mai des recomandată, un obiect as const cu un tip derivat din el.

De ce apare: cauzele frecvente

1Lista valorilor unui const enum

Greșit
TypeScript
const enum Marime { S = 'S', M = 'M', L = 'L' }
console.log(Object.values(Marime));
Corect
TypeScript
enum Marime { S = 'S', M = 'M', L = 'L' }
console.log(Object.values(Marime));

Un enum obișnuit există la rulare ca obiect, deci Object.values îl poate parcurge.

2Obiect as const în loc de enum

Greșit
TypeScript
const enum Rol { Admin = 'admin', User = 'user' }
for (const r in Rol) {}
Corect
TypeScript
const Rol = { Admin: 'admin', User: 'user' } as const;
type Rol = (typeof Rol)[keyof typeof Rol];
for (const r in Rol) {}

Obiectul există la rulare, iar tipul Rol e derivat din valorile lui.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2475: 'const' enums can only be used in property or index access expressions.... Programul afișează toate mărimile disponibile. Repară declarația enum-ului ca programul să afișeze Mărimi: S, M, L, XL.

Codul care dă eroarea
TypeScript
const enum Marime {
  S = 'S',
  M = 'M',
  L = 'L',
  XL = 'XL',
}
const toate: string[] = Object.values(Marime);
console.log(`Mărimi: ${toate.join(', ')}`);
După reparație, programul afișează
Mărimi: S, M, L, XL
Indiciu

Lista valorilor are nevoie de un obiect care să existe la rulare.

Cum o eviți pe viitor

  • Folosește const enum doar când accesezi membrii individual și nu ai nevoie de lista lor.
  • Pentru meniuri, validări și liste de opțiuni, folosește un enum obișnuit sau un obiect as const.
  • În proiectele cu isolatedModules (Vite, esbuild, Babel), evită const enum exportate: aceste unelte nu le pot înlocui între fișiere.

Întrebări frecvente

Atunci de ce ar folosi cineva const enum?

Pentru cod mai mic și mai rapid: nu se generează obiectul, iar valorile sunt scrise direct. Avantajul contează rar în aplicații obișnuite, iar limitările apar des, de aceea multe proiecte îl evită.

Ce e mai bine: enum sau obiect as const?

Ambele merg. Obiectul as const e JavaScript obișnuit, merge cu orice unealtă de build și permite tipuri derivate (keyof typeof). enum are o sintaxă mai scurtă și e familiar din alte limbaje.

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.