SyntaxError: Lexical declaration cannot appear in a single-statement context
Ai scris o declarație `let` direct după un `if`, `else`, `for` sau `while` fără acolade, de exemplu `if (ok) let x = 1;`. Declarațiile cu `let` au nevoie de un bloc. Declară variabila înainte de condiție și doar atribuie-i valoarea, sau pune acolade.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
După if (...), else, for (...) sau while (...) fără acolade poate urma o singură instrucțiune (un „single-statement context”). O declarație let nu are voie să fie acea singură instrucțiune, pentru că variabila ar trăi într-un bloc care nu există și nu ar putea fi folosită nicăieri.
Aceeași greșeală cu const sau class dă în V8 (Chrome, Node) mesajul SyntaxError: Unexpected token 'const', iar în Firefox lexical declarations can't appear in single-statement context.
De obicei greșeala ascunde și o problemă de logică: chiar cu acolade, if (ok) { let x = 1; } creează x doar în interiorul blocului, iar după } variabila nu mai există. Soluția corectă e aproape mereu să declari variabila înainte de if și doar să-i dai valoarea în condiție.
Eroarea e de sintaxă, deci fișierul nu rulează deloc.
De ce apare: cauzele frecvente
1Declarație într-un if fără acolade
const varsta = 20;
if (varsta >= 18) let mesaj = "major";
console.log(mesaj);const varsta = 20;
let mesaj = "minor";
if (varsta >= 18) mesaj = "major";
console.log(mesaj);Variabila se declară în afara lui if, iar în condiție doar i se schimbă valoarea, care rămâne vizibilă după.
2Declarație în corpul unei bucle fără acolade
for (const p of produse) let pret = p.pret * 1.19;for (const p of produse) {
const pret = p.pret * 1.19;
console.log(pret);
}Cu acolade, corpul buclei devine un bloc în care declarația e permisă și are sens.
3else urmat direct de let
if (stoc > 0) vinde();
else let motiv = "lipsă stoc";let motiv = "";
if (stoc > 0) vinde();
else motiv = "lipsă stoc";Aceeași regulă pentru else: fără bloc nu poți declara, iar o variabilă declarată în bloc nu se vede după.
Repară eroarea, direct în pagină
Programul de mai jos alege mesajul pentru o comandă după valoarea ei, dar nu pornește: SyntaxError: Lexical declaration cannot appear in a single-statement context. Repară-l ca să afișeze Total: 320 lei și Livrare gratuită.
const total = 320;
if (total >= 200) let mesaj = "Livrare gratuită";
else let mesaj = "Livrare 15 lei";
console.log(`Total: ${total} lei`);
console.log(mesaj);Total: 320 lei Livrare gratuită
Indiciu
Declară mesaj înainte de if, cu o valoare inițială, iar în condiție doar schimbă-i valoarea.
Reparația
const total = 320;
let mesaj;
if (total >= 200) mesaj = "Livrare gratuită";
else mesaj = "Livrare 15 lei";
console.log(`Total: ${total} lei`);
console.log(mesaj);De ce merge
let după un if sau else fără acolade e interzis, pentru că variabila nu ar avea un bloc în care să existe. Chiar cu acolade, mesaj ar dispărea după } și console.log(mesaj) ar da ReferenceError. Declarând let mesaj o singură dată, înainte de condiție, variabila e vizibilă în tot programul, iar ramurile doar îi atribuie valoarea. Varianta și mai scurtă: const mesaj = total >= 200 ? "Livrare gratuită" : "Livrare 15 lei";.
Alte forme ale mesajului
SyntaxError: lexical declarations can't appear in single-statement contextSyntaxError: Unexpected token 'const'
Cum o eviți pe viitor
- Pune mereu acolade la
if,else,forșiwhile, chiar și pentru o singură linie (regulacurlydin ESLint). - Declară variabilele care trebuie folosite după condiție înainte de
if. - Pentru valori alese după o condiție, folosește operatorul ternar:
const mesaj = varsta >= 18 ? "major" : "minor";.
Întrebări frecvente
De ce cu const mesajul e altul?
În V8, const și class sunt cuvinte rezervate, așa că parserul se oprește mai devreme cu Unexpected token 'const'. let e un cuvânt contextual, deci parserul ajunge să recunoască declarația și dă mesajul acesta. Cauza și reparația sunt aceleași.
Și dacă pun acolade, merge?
Da, eroarea de sintaxă dispare. Dar variabila există doar în acel bloc; dacă o folosești după }, vei primi ReferenceError: ... is not defined.
Erori înrudite
ReferenceError: pret is not defined Folosești un nume (variabilă sau funcție) pe care JavaScript nu îl găsește nicăieri în locul acela: nu a fost declarat, e scris diferit (literele mari contează) sau a fost declarat în alt bloc ori în altă funcție. Declară-l cu `const`/`let` sau corectează numele. SyntaxError: Unexpected token '}' Motorul JavaScript a dat peste un simbol care nu are ce căuta în acel loc, de obicei o acoladă, o paranteză sau un cuvânt-cheie în plus ori lipsă. Verifică linia indicată și pe cea dinainte: numără acoladele și parantezele și caută o virgulă, un operator sau o paranteză care lipsește. SyntaxError: Missing initializer in const declaration Ai declarat o variabilă cu `const` fără să îi dai o valoare pe aceeași linie. O constantă primește valoarea o singură dată, la declarare: scrie `const x = valoare;`. Dacă valoarea se află mai târziu, folosește `let`. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
