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.
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
const enum Marime { S = 'S', M = 'M', L = 'L' }
console.log(Object.values(Marime));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
const enum Rol { Admin = 'admin', User = 'user' }
for (const r in Rol) {}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ă 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.
const enum Marime {
S = 'S',
M = 'M',
L = 'L',
XL = 'XL',
}
const toate: string[] = Object.values(Marime);
console.log(`Mărimi: ${toate.join(', ')}`);Mărimi: S, M, L, XL
Indiciu
Lista valorilor are nevoie de un obiect care să existe la rulare.
Reparația
enum Marime {
S = 'S',
M = 'M',
L = 'L',
XL = 'XL',
}
const toate: string[] = Object.values(Marime);
console.log(`Mărimi: ${toate.join(', ')}`);De ce merge
Un const enum e șters la compilare: fiecare Marime.S devine direct 'S', iar obiectul Marime nu mai există. Object.values(Marime) are însă nevoie de obiect. Fără const, enum-ul e compilat ca un obiect JavaScript cu cele patru chei, iar Object.values întoarce valorile în ordinea declarării.
Cum o eviți pe viitor
- Folosește
const enumdoar când accesezi membrii individual și nu ai nevoie de lista lor. - Pentru meniuri, validări și liste de opțiuni, folosește un
enumobișnuit sau un obiectas const. - În proiectele cu
isolatedModules(Vite, esbuild, Babel), evităconst enumexportate: 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
error TS1061: Enum member must have initializer. Într-un enum, după un membru cu valoare text (A = 'a'), următorii membri nu mai pot primi automat un număr. Dă fiecărui membru o valoare explicită. error TS2678: Type '"Card"' is not comparable to type 'Plata'. Într-un switch, un case are o valoare care nu poate apărea niciodată în tipul expresiei, de obicei din cauza unei litere mari sau a unei greșeli de tipar ("Card" în loc de "card"). Scrie valoarea exact ca în tipul uniune. error TS2708: Cannot use namespace 'Api' as a value. Namespace-ul conține doar tipuri (interfețe, type), deci la rulare nu există. Tu îl folosești ca valoare: new Api.Produs(), console.log(Api) sau Api.ceva într-o expresie. Folosește tipurile doar în adnotări (const p: Api.Produs = {...}) sau adaugă în namespace o valoare reală (o funcție, o clasă). Î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.
