...
Eroare TypeScript · Tipuri de bază, nume și variabile

error TS2448: Block-scoped variable 'total' used before its declaration.

Pe scurt

Folosești o variabilă declarată cu let sau const pe o linie de deasupra declarației ei. Mută declarația mai sus, înainte de prima folosire, sau mută codul care o folosește după ea.

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

Ce înseamnă

Variabilele let și const există în tot blocul, dar nu pot fi folosite înainte de linia unde sunt declarate. Intervalul dintre începutul blocului și declarație se numește temporal dead zone; dacă JavaScript ar ajunge să citească variabila acolo, ar arunca ReferenceError: Cannot access 'total' before initialization. TypeScript vede problema dinainte și o raportează la compilare.

De obicei mesajul vine împreună cu TS2454 (Variable 'total' is used before being assigned), pentru aceeași linie. Linia indicată este locul unde folosești variabila, nu cel unde o declari.

Apare des după ce muți cod: copiezi un console.log mai sus, inversezi două calcule sau folosești o constantă într-o funcție apelată înainte ca acea constantă să fie declarată.

De ce apare: cauzele frecvente

1Calcule în ordinea greșită

Greșit
TypeScript
const cuTva = pret * 1.19;
const pret = 100;
Corect
TypeScript
const pret = 100;
const cuTva = pret * 1.19;

Valoarea trebuie să existe înainte să o folosești; inversezi cele două linii.

2Afișare mutată deasupra declarației

Greșit
TypeScript
console.log(mesaj);
const mesaj = "Salut";
Corect
TypeScript
const mesaj = "Salut";
console.log(mesaj);

console.log citește variabila, deci trebuie să vină după declarație.

3Obiect care se referă la el însuși

Greșit
TypeScript
const config = {
  url: config.baza + "/api",
  baza: "https://x.ro",
};
Corect
TypeScript
const baza = "https://x.ro";
const config = {
  baza,
  url: baza + "/api",
};

Cât timp obiectul se construiește, config nu există încă. Scoți valoarea comună într-o variabilă separată.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2448: Block-scoped variable 'reducere' used before its declaration. Reordonează liniile ca programul să compileze și să afișeze Preț final: 90 lei.

Codul care dă eroarea
TypeScript
const pret = 100;
const pretFinal = pret - reducere;
const reducere = pret * 0.1;
console.log(`Preț final: ${pretFinal} lei`);
După reparație, programul afișează
Preț final: 90 lei
Indiciu

Constanta reducere trebuie declarată înainte de linia care calculează pretFinal.

Alte forme ale mesajului

  • error TS2448: Block-scoped variable 'config' used before its declaration.

Cum o eviți pe viitor

  • Declară variabilele sus, în ordinea în care se calculează una din alta.
  • Când muți o linie, verifică dacă variabilele pe care le folosește sunt declarate deasupra ei.
  • Nu construi un obiect folosind chiar obiectul respectiv; calculează valorile comune înainte.
  • Funcțiile declarate cu function pot fi apelate înainte de declarație, dar constantele pe care le citesc trebuie să fie deja inițializate.

Întrebări frecvente

Care e diferența față de TS2454?

TS2448 spune că folosești variabila mai sus decât declarația ei. TS2454 spune că variabila e declarată, dar s-ar putea să nu aibă încă valoare. Aici le primești pe amândouă pentru aceeași linie; reparația e aceeași: mută declarația mai sus.

De ce funcțiile pot fi folosite înainte de declarație, dar const nu?

Declarațiile function sunt ridicate complet (hoisting) la începutul blocului. Pentru let și const e ridicat doar numele, nu și valoarea, deci până la linia declarației variabila e inaccesibilă.

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.