...
Eroare Node.js · Module ES: import, export și "type": "module"

SyntaxError: Illegal return statement

Pe scurt

Ai scris return în afara unei funcții, la nivelul de sus al unui modul ES. În CommonJS Node acceptă asta, în modulele ES nu. Pune codul într-o funcție main() și ieși din ea cu return, sau folosește if / else.

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

Ce înseamnă

return are sens doar într-o funcție. În CommonJS, Node învelește fiecare fișier într-o funcție ascunsă, așa că un return la nivelul de sus oprește pur și simplu restul fișierului și programele vechi foloseau asta pentru „ieșire rapidă”.

Modulele ES (import / export, .mjs sau "type": "module") nu mai sunt învelite într-o funcție, deci return la nivelul de sus devine o greșeală de sintaxă: Illegal return statement. Fiind eroare de sintaxă, nimic din fișier nu rulează.

Apare tipic când transformi un script CommonJS în modul ES (adaugi un import sau "type": "module") și scriptul avea gărzi de forma if (!fs.existsSync(f)) return;. Linia din mesaj arată exact acel return.

De ce apare: cauzele frecvente

1Gardă cu return la nivelul de sus

Greșit
JavaScript
import fs from "node:fs";
if (!fs.existsSync("comenzi.json")) {
  console.log("Nu există comenzi.");
  return;
}
Corect
JavaScript
import fs from "node:fs";
function main() {
  if (!fs.existsSync("comenzi.json")) {
    console.log("Nu există comenzi.");
    return;
  }
  // ...
}
main();

În interiorul funcției main, return e valid și oprește doar funcția.

2Oprire cu cod de ieșire

Greșit
JavaScript
if (!process.env.API_KEY) return;
Corect
JavaScript
if (!process.env.API_KEY) {
  console.error("Lipsește API_KEY");
  process.exit(1);
}

Dacă vrei să oprești programul cu eroare, process.exit(1) merge în orice tip de modul și îi spune și shell-ului că programul a eșuat.

3Varianta cu if / else

Greșit
JavaScript
if (lista.length === 0) return;
afiseaza(lista);
Corect
JavaScript
if (lista.length === 0) {
  console.log("Lista e goală.");
} else {
  afiseaza(lista);
}

Pentru o ramificație simplă, if / else e cea mai clară variantă și nu are nevoie de return.

Repară tu

Repară eroarea, direct în pagină

Scriptul (modul ES) calculează totalul comenzilor din comenzi.json, dar are un return la nivelul de sus și Node refuză să-l ruleze cu SyntaxError: Illegal return statement. Mută codul într-o funcție main() pe care o apelezi la final, ca scriptul să afișeze totalul comenzilor.

Codul care dă eroarea
JavaScript
import fs from "node:fs";

const fisier = "comenzi.json";
if (!fs.existsSync(fisier)) {
  console.log("Nu există comenzi.");
  return;
}

const comenzi = JSON.parse(fs.readFileSync(fisier, "utf8"));
const total = comenzi.reduce((s, c) => s + c.suma, 0);
console.log(`Comenzi: ${comenzi.length}`);
console.log(`Total: ${total} lei`);
După reparație, programul afișează
Comenzi: 3
Total: 315 lei
Indiciu

Pune tot codul de după importuri în function main() { ... } și scrie main(); la sfârșit.

Alte forme ale mesajului

  • SyntaxError: 'return' outside of function

Cum o eviți pe viitor

  • Pune logica scripturilor într-o funcție main() (sau async function main()) și apeleaz-o la final; poți folosi return oricând.
  • Când treci un fișier pe module ES, caută return la nivelul de sus.
  • Pentru oprire cu eroare folosește process.exit(1) sau process.exitCode = 1.
  • Ține minte că await la nivelul de sus e permis în module ES, dar return nu.

Întrebări frecvente

De ce același cod mergea înainte?

Fișierul era CommonJS, unde Node îl învelește într-o funcție și return e permis. După ce ai adăugat import sau "type": "module", fișierul a devenit modul ES, cu alte reguli.

Pot folosi process.exit() în loc?

Da, dar process.exit() oprește tot procesul imediat, inclusiv scrierile sau cererile încă în desfășurare. Pentru ieșirea dintr-o ramură, o funcție main cu return e mai sigură.

Erori înrudite

← Toate erorile Node.js

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ță Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.