SyntaxError: Illegal return statement
Ai scris return în afara oricărei funcții: direct în codul de la nivelul de sus al fișierului sau într-un bloc static al unei clase. return are sens doar în interiorul unei funcții: mută codul într-o funcție sau înlocuiește return cu un if/else.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Instrucțiunea return încheie execuția funcției curente și trimite o valoare înapoi celui care a apelat-o. La nivelul de sus al unui script nu există nicio funcție de încheiat, așa că motorul JavaScript respinge codul încă de la parsare, înainte să ruleze vreo linie: Illegal return statement.
Greșeala apare des când copiezi o bucată din corpul unei funcții direct în fișier, când vrei să „oprești scriptul” la o condiție (cum ai face cu exit în alte limbaje) sau când o acoladă de închidere pusă prea devreme scoate return din funcție fără să-ți dai seama.
Același mesaj apare și într-un bloc static { ... } al unei clase: deși seamănă cu o funcție, blocul static nu e funcție și nu acceptă return.
Linia din mesaj îți arată return-ul vinovat. Uită-te în sus de el: dacă nu e în nicio funcție, mută codul într-o funcție. Dacă este, numără acoladele: probabil un } închide funcția mai devreme decât credeai.
De ce apare: cauzele frecvente
1Vrei să oprești scriptul la o condiție
const cos = [];
if (cos.length === 0) {
console.log("Coșul este gol");
return;
}
console.log("Plasez comanda");const cos = [];
if (cos.length === 0) {
console.log("Coșul este gol");
} else {
console.log("Plasez comanda");
}La nivelul de sus nu ai din ce funcție să ieși. Un if/else face același lucru: restul codului rulează doar pe ramura potrivită.
2Cod copiat din corpul unei funcții
const pret = 120;
const reducere = pret > 100 ? 10 : 0;
return pret - reducere;function pretFinal(pret) {
const reducere = pret > 100 ? 10 : 0;
return pret - reducere;
}
console.log(pretFinal(120));Codul cu return trebuie să stea într-o funcție, iar rezultatul îl folosești la apel.
3O acoladă închide funcția prea devreme
function verifica(stoc) {
if (stoc > 0) {
console.log("În stoc");
}}
return stoc > 0;
}function verifica(stoc) {
if (stoc > 0) {
console.log("În stoc");
}
return stoc > 0;
}Acolada în plus închide funcția după if, iar return ajunge la nivelul de sus. Formatarea automată a editorului face problema vizibilă.
4return într-un bloc static al clasei
class Config {
static {
if (!globalThis.setari) return;
Config.tema = setari.tema;
}
}class Config {
static {
if (globalThis.setari) {
Config.tema = setari.tema;
}
}
}Blocul static rulează o singură dată, la definirea clasei, dar nu e o funcție. Folosești if în loc de ieșire anticipată.
Repară eroarea, direct în pagină
Clasa Magazin își încarcă stocul într-un bloc static, iar acolo folosește return ca să iasă devreme când stocul inițial e gol. Fișierul nu pornește: SyntaxError: Illegal return statement. Rescrie blocul static cu if/else, fără return, ca programul să afișeze cele două rânduri așteptate.
const stocInitial = [];
class Magazin {
static produse = [];
static {
if (stocInitial.length === 0) {
console.log("Stoc gol, pornesc cu lista implicită");
Magazin.produse = ["pâine", "lapte"];
return;
}
Magazin.produse = [...stocInitial];
}
}
console.log(`Produse: ${Magazin.produse.join(", ")}`);Stoc gol, pornesc cu lista implicită Produse: pâine, lapte
Indiciu
Un bloc static nu e funcție: pune cele două variante pe ramurile unui if/else.
Reparația
const stocInitial = [];
class Magazin {
static produse = [];
static {
if (stocInitial.length === 0) {
console.log("Stoc gol, pornesc cu lista implicită");
Magazin.produse = ["pâine", "lapte"];
} else {
Magazin.produse = [...stocInitial];
}
}
}
console.log(`Produse: ${Magazin.produse.join(", ")}`);De ce merge
Blocul static { ... } rulează o singură dată, când se definește clasa, dar nu este o funcție, deci nu are din ce să iasă cu return. Motorul respinge fișierul la parsare. Cu if/else, cele două variante sunt ramuri separate: stocul gol duce la lista implicită, altfel se copiază stocul inițial. Rezultatul e același, fără nicio ieșire anticipată.
Alte forme ale mesajului
Uncaught SyntaxError: Illegal return statementSyntaxError: return not in function
Cum o eviți pe viitor
- Pune logica într-o funcție și apeleaz-o: așa ai voie să folosești
returnpentru ieșiri rapide. - La nivelul de sus, folosește
if/elseîn loc de „oprește scriptul aici”. - Lasă editorul să formateze codul (Prettier): acoladele greșite se văd imediat prin indentare.
- Când copiezi cod dintr-o funcție, copiază și antetul funcției sau înlocuiește
returncu o variabilă.
Întrebări frecvente
De ce în Node, într-un fișier .js vechi, return la nivelul de sus merge uneori?
În modulele CommonJS, Node înfășoară fișierul într-o funcție, așa că un return sus nu dă eroare. În browser și în modulele ES (import/export) nu există această funcție, deci primești Illegal return statement. Nu te baza pe comportamentul CommonJS.
Cum opresc tot scriptul, ca exit() din alte limbaje?
În browser nu există un exit. Poți arunca o eroare (throw new Error(...)), dar mai curat e să pui codul într-o funcție main() și să faci return din ea.
Erori înrudite
SyntaxError: Illegal break statement Ai folosit `break` în afara unei bucle sau a unui `switch`, de obicei în callback-ul lui `forEach`, care e o funcție separată, nu o buclă. Folosește `for...of` (unde `break` funcționează) sau metode care se opresc singure: `find`, `some`, `every`. 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: Unexpected end of input Fișierul s-a terminat înainte ca motorul să găsească închiderea a ceva deschis: de obicei o acoladă `}` a unei funcții sau a unui `if`, o paranteză `)` sau un template literal neînchis. Caută blocul deschis care nu are pereche și adaugă închiderea. Î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.
