...
Eroare TypeScript · Clase și interfețe implementate

error TS2449: Class 'Comanda' used before its declaration.

Pe scurt

Folosești o clasă (new Comanda(), extends Comanda) pe o linie aflată deasupra declarației ei. Clasele nu sunt „ridicate” ca funcțiile: mută declarația clasei înainte de primul cod care o folosește.

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

Ce înseamnă

Declarațiile function sunt „ridicate” (hoisting): poți apela o funcție mai sus decât e scrisă. Clasele nu: o clasă există abia după ce rulează linia class Comanda {...}. Dacă new Comanda() rulează înainte, JavaScript aruncă ReferenceError: Cannot access 'Comanda' before initialization. TypeScript prinde asta la compilare, cu TS2449.

Apare des când pui codul principal sus și clasele jos, ca într-un script Python sau Java, sau când o clasă extinde altă clasă declarată mai jos în același fișier (class Card extends Plata, cu Plata dedesubt).

Linia din mesaj arată folosirea. Mută clasa deasupra, sau pune codul care o folosește într-o funcție apelată după declarații. Folosirea unei clase într-o funcție declarată înaintea ei e în regulă, cât timp funcția e apelată după declarație.

De ce apare: cauzele frecvente

1new înainte de declarație

Greșit
TypeScript
const c = new Comanda(1);
class Comanda {
  constructor(public id: number) {}
}
Corect
TypeScript
class Comanda {
  constructor(public id: number) {}
}
const c = new Comanda(1);

Clasa trebuie să existe când rulează new.

2extends cu clasa de bază mai jos

Greșit
TypeScript
class Card extends Plata {}
class Plata {}
Corect
TypeScript
class Plata {}
class Card extends Plata {}

Clasa de bază trebuie declarată înaintea celor care o extind.

3Cod principal pus într-o funcție

Greșit
TypeScript
main();
function main() { new Comanda(1); }
class Comanda { constructor(public id: number) {} }
Corect
TypeScript
function main() { new Comanda(1); }
class Comanda { constructor(public id: number) {} }
main();

Funcția poate menționa clasa, dar trebuie apelată după ce clasa e declarată.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2449: Class 'Comanda' used before its declaration. Programul creează o comandă și îi afișează descrierea. Repară ordinea ca programul să afișeze Comanda 501: 3 produse.

Codul care dă eroarea
TypeScript
const comanda = new Comanda(501, 3);
console.log(comanda.descriere());
class Comanda {
  constructor(public id: number, public produse: number) {}
  descriere(): string {
    return `Comanda ${this.id}: ${this.produse} produse`;
  }
}
După reparație, programul afișează
Comanda 501: 3 produse
Indiciu

O clasă trebuie să existe înainte de new.

Alte forme ale mesajului

  • error TS2449: Class 'Plata' used before its declaration.

Cum o eviți pe viitor

  • Pune declarațiile de clase la începutul fișierului sau în fișiere separate, importate sus.
  • Pune codul principal într-o funcție main() apelată la final.
  • Ordonează clasele astfel încât clasele de bază să fie înaintea celor derivate.
  • Același lucru e valabil pentru let, const și enum: declară-le înainte să le folosești.

Întrebări frecvente

De ce funcțiile merg înainte de declarație, iar clasele nu?

Declarațiile function sunt create complet înainte să ruleze orice cod din scope. Clasele (ca let și const) sunt doar rezervate, dar rămân neinițializate până la linia lor: zona dintre se numește „temporal dead zone”.

Ce diferență e față de TS2448?

TS2448 e același lucru pentru variabile let/const (Block-scoped variable used before its declaration). TS2449 e varianta pentru clase, iar TS2450 pentru enum-uri.

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.