...
Eroare React · Sintaxă JSX și compilare

'return' outside of function.

Pe scurt

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 de return, de exemplu după un if sau un map;
  • 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

Greșit
JSX
import { useState } from "react";

const [n, setN] = useState(0);
return <p>{n}</p>;
Corect
JSX
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

Greșit
JSX
export default function App() {
  const total = 3;
  if (total > 0) {
    console.log(total);
  }}
  return <p>{total}</p>;
}
Corect
JSX
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

Greșit
JSX
const Card = (props) =>
  return <h3>{props.titlu}</h3>;
Corect
JSX
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ă tu

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”.

Codul care dă eroarea
JSX
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.

Alte forme ale mesajului

  • SyntaxError: 'return' outside of function. (4:0)
  • SyntaxError: Illegal return statement
  • A '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

← Toate erorile React

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