'return' outside of function.
Babel a găsit un return care nu este în interiorul unei funcții. De obicei lipsește antetul componentei (function App() {), o acoladă se închide prea devreme sau JSX-ul a fost lipit direct în fișier. Pune return-ul în corpul componentei și verifică perechile de acolade.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
return are sens doar într-o funcție: el întoarce rezultatul funcției. Când compilatorul (Babel, esbuild în Vite) îl găsește la nivelul fișierului, în afara oricărei funcții, se oprește cu 'return' outside of function și îți arată linia și coloana.
În React, asta se întâmplă aproape mereu din unul din trei motive:
- ai copiat doar corpul unei componente (
return <div>...</div>;) fărăfunction Nume() {; - o acoladă
}închide funcția înainte dereturn, de exemplu după unifsau unmap; - ai scris o componentă-săgeată cu acolade și ai uitat săgeata sau parantezele.
Ca să găsești locul, du-te la linia din mesaj și urcă în sus, numărând acoladele: ultima { deschisă înainte de return trebuie să fie a funcției componentei. Editorul colorează perechile de acolade: pune cursorul pe fiecare și vezi unde se închide.
De ce apare: cauzele frecvente
1Lipsește antetul componentei
import { useState } from "react";
const [n, setN] = useState(0);
return <p>{n}</p>;import { useState } from "react";
export default function App() {
const [n, setN] = useState(0);
return <p>{n}</p>;
}Codul fără function App() { stă direct în modul, unde return nu e permis. În funcție, return întoarce JSX-ul componentei.
2Acoladă închisă prea devreme
export default function App() {
const total = 3;
if (total > 0) {
console.log(total);
}}
return <p>{total}</p>;
}export default function App() {
const total = 3;
if (total > 0) {
console.log(total);
}
return <p>{total}</p>;
}A doua acoladă de după if închidea funcția, iar return rămânea afară.
3Funcție-săgeată scrisă greșit
const Card = (props) =>
return <h3>{props.titlu}</h3>;const Card = (props) => {
return <h3>{props.titlu}</h3>;
};
// sau: const Card = (props) => <h3>{props.titlu}</h3>;După => fără acolade vine direct expresia, nu return. Cu acolade, corpul e un bloc și return e permis.
Repară eroarea, direct în pagină
Fișierul de mai jos nu compilează: Babel spune „'return' outside of function”. Repară-l ca pagina să afișeze titlul h1 „Coșul tău” și paragraful #total cu textul „Total: 75 lei”.
const produse = [
{ nume: "Cană", pret: 25 },
{ nume: "Ceainic", pret: 50 },
];
export default function App() {
let total = 0;
for (const p of produse) {
if (p.pret > 0) {
total += p.pret;
}
}}
return (
<div>
<h1>Coșul tău</h1>
<p id="total">Total: {total} lei</p>
</div>
);
}Indiciu
Numără acoladele de după if: una dintre ele închide funcția prea devreme.
Reparația
const produse = [
{ nume: "Cană", pret: 25 },
{ nume: "Ceainic", pret: 50 },
];
export default function App() {
let total = 0;
for (const p of produse) {
if (p.pret > 0) {
total += p.pret;
}
}
return (
<div>
<h1>Coșul tău</h1>
<p id="total">Total: {total} lei</p>
</div>
);
}De ce merge
Acolada în plus de după for închidea funcția App înainte de return. Pentru Babel, return (...) ajungea astfel la nivelul fișierului, unde nu are ce întoarce, iar ultima acoladă rămânea fără pereche.
Cu o singură acoladă după for, return stă în corpul componentei. Bucla adună prețurile (25 + 50), iar JSX-ul afișează totalul calculat.
Alte forme ale mesajului
SyntaxError: 'return' outside of function. (4:0)SyntaxError: Illegal return statementA 'return' statement can only be used within a function body.ERROR: Top-level return cannot be used inside an ECMAScript module
Cum o eviți pe viitor
- Pornește fiecare componentă din același schelet:
export default function Nume() { ... return (...); }. - Lasă editorul să formateze codul (Prettier): o acoladă în plus se vede imediat după indentarea greșită.
- Când lipești cod dintr-un exemplu, verifică dacă ai copiat și antetul funcției.
- La funcțiile-săgeată alege una din două forme: fără acolade (doar expresia) sau cu acolade și
return.
Întrebări frecvente
Codul arată bine, dar eroarea indică ultima linie. De ce?
Compilatorul arată locul unde și-a dat seama de problemă, nu unde ai greșit. O acoladă în plus mai sus închide funcția, iar tot ce urmează e considerat la nivelul fișierului. Caută perechea fiecărei acolade de sus în jos.
E la fel cu „Illegal return statement”?
Da. Este același lucru spus de motorul JavaScript al browserului (V8), când codul ajunge să ruleze fără să fi fost compilat de Babel.
Erori înrudite
SyntaxError: Unexpected token Între acoladele din JSX ai pus o instrucțiune (if, for, o declarație) sau un comentariu HTML. Acolo merg doar expresii: folosește condiție && <p>...</p>, operatorul ? : sau map. Adjacent JSX elements must be wrapped in an enclosing tag. Did you want a JSX fragment <>...</>? Componenta returnează două sau mai multe elemente JSX unul lângă altul, fără un părinte comun. O funcție poate întoarce o singură valoare, deci le pui într-un fragment <>...</> sau într-un <div>. Unterminated JSX contents. Un element JSX a rămas deschis până la finalul blocului, cel mai des un tag gol scris ca în HTML (<input>, <img>, <br>) fără /. În JSX toate elementele se închid: <input />, <br />. Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
