SyntaxError: Illegal return statement
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
import fs from "node:fs";
if (!fs.existsSync("comenzi.json")) {
console.log("Nu există comenzi.");
return;
}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
if (!process.env.API_KEY) return;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
if (lista.length === 0) return;
afiseaza(lista);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ă 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.
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`);Comenzi: 3 Total: 315 lei
Indiciu
Pune tot codul de după importuri în function main() { ... } și scrie main(); la sfârșit.
Reparația
import fs from "node:fs";
function main() {
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`);
}
main();De ce merge
Un modul ES nu e învelit într-o funcție, deci un return la nivelul de sus e o greșeală de sintaxă și oprește tot fișierul înainte să ruleze. În main() același return e valid: dacă fișierul lipsește, funcția afișează mesajul și se oprește; altfel calculează totalul. Structura cu main() e și mai ușor de testat și de extins.
Alte forme ale mesajului
SyntaxError: 'return' outside of function
Cum o eviți pe viitor
- Pune logica scripturilor într-o funcție
main()(sauasync function main()) și apeleaz-o la final; poți folosireturnoricând. - Când treci un fișier pe module ES, caută
returnla nivelul de sus. - Pentru oprire cu eroare folosește
process.exit(1)sauprocess.exitCode = 1. - Ține minte că
awaitla nivelul de sus e permis în module ES, darreturnnu.
Î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
SyntaxError: Cannot use import statement outside a module Node încarcă fișierul ca modul CommonJS, unde import nu e permis. Ori treci pe require, ori spui că fișierul e modul ES: extensia .mjs sau "type": "module" în package.json. Fișierele .cjs și proiectele cu "type": "commonjs" acceptă doar require. ReferenceError: require is not defined in ES module scope, you can use import instead Fișierul este modul ES (are import/export, extensia .mjs sau "type": "module" în package.json), iar în modulele ES require nu există. Înlocuiește require cu import: const fs = require("fs") devine import fs from "fs". Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. Î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.
