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

error TS2450: Enum 'Status' used before its declaration.

Pe scurt

Folosești un membru de enum (Status.Activ) pe o linie de deasupra declarației enum-ului. Enum-urile sunt valori create la rulare, în ordinea codului. Mută declarația enum deasupra primei folosiri (sau într-un fișier separat, importat).

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

Ce înseamnă

Spre deosebire de interfețe și type alias-uri, care dispar la compilare, un enum normal devine un obiect JavaScript creat când execuția ajunge la declarația lui. Dacă îl citești înainte, de exemplu într-o constantă de la începutul fișierului, obiectul nu există încă.

TypeScript detectează folosirea la nivelul de sus, înainte de declarație, și dă TS2450. Fără verificare, la rulare ai primi ReferenceError: Cannot access 'Status' before initialization (sau undefined, în funcție de cum e generat codul).

Folosirea într-o funcție declarată deasupra enum-ului e permisă, pentru că funcția rulează abia când e apelată, de obicei după ce enum-ul a fost creat. Problema apare doar la codul care rulează imediat. Eroarea e înrudită cu TS2449 (clase) și TS2448 (let / const).

De ce apare: cauzele frecvente

1Constantă la începutul fișierului, enum la final

Greșit
TypeScript
const implicit = Status.Activ;
enum Status { Activ = 'ACTIV', Inactiv = 'INACTIV' }
Corect
TypeScript
enum Status { Activ = 'ACTIV', Inactiv = 'INACTIV' }
const implicit = Status.Activ;

Enum-ul e un obiect creat la rulare, deci trebuie declarat înainte de prima citire care rulează imediat.

2Enum folosit într-un obiect de configurare de deasupra

Greșit
TypeScript
const config = { nivel: Nivel.Info };
enum Nivel { Info, Eroare }
Corect
TypeScript
enum Nivel { Info, Eroare }
const config = { nivel: Nivel.Info };

Obiectul config e construit imediat, deci are nevoie ca Nivel să existe deja.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2450: Enum 'Status' used before its declaration. Statusul implicit al unui cont nou trebuie să fie ACTIV. Reordonează codul ca programul să afișeze ACTIV și apoi INACTIV.

Codul care dă eroarea
TypeScript
const implicit = Status.Activ;
console.log(implicit);

enum Status {
  Activ = 'ACTIV',
  Inactiv = 'INACTIV',
}

console.log(Status.Inactiv);
După reparație, programul afișează
ACTIV
INACTIV
Indiciu

Un enum devine un obiect la rulare: trebuie să existe înainte de linia care îl citește.

Alte forme ale mesajului

  • error TS2450: Enum 'Nivel' used before its declaration.

Cum o eviți pe viitor

  • Declară enum-urile și tipurile în partea de sus a fișierului sau, mai bine, într-un fișier separat (status.ts) pe care îl imporți.
  • Reține diferența: interfețele și type alias-urile pot fi folosite oriunde, enum-urile și clasele doar după declarare.
  • Ca alternativă fără cod la rulare, folosește o uniune de literale (type Status = 'ACTIV' | 'INACTIV').

Întrebări frecvente

De ce o funcție de deasupra poate folosi enum-ul?

Pentru că corpul funcției rulează doar la apel. Dacă o apelezi după declarația enum-ului, obiectul există deja. TypeScript raportează doar folosirile care rulează sigur înainte de declarație.

La const enum apare eroarea?

Da, regula e aceeași, chiar dacă un const enum e înlocuit la compilare cu valorile lui. Mută declarația deasupra folosirii.

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.