...
Eroare JavaScript · Erori de sintaxă (SyntaxError)

SyntaxError: Illegal return statement

Pe scurt

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

Greșit
JavaScript
const cos = [];
if (cos.length === 0) {
  console.log("Coșul este gol");
  return;
}
console.log("Plasez comanda");
Corect
JavaScript
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

Greșit
JavaScript
const pret = 120;
const reducere = pret > 100 ? 10 : 0;
return pret - reducere;
Corect
JavaScript
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

Greșit
JavaScript
function verifica(stoc) {
  if (stoc > 0) {
    console.log("În stoc");
  }}
  return stoc > 0;
}
Corect
JavaScript
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

Greșit
JavaScript
class Config {
  static {
    if (!globalThis.setari) return;
    Config.tema = setari.tema;
  }
}
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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(", ")}`);
După reparație, programul afișează
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.

Alte forme ale mesajului

  • Uncaught SyntaxError: Illegal return statement
  • SyntaxError: 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 return pentru 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 return cu 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

← Toate erorile JavaScript

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ță 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.