...
Eroare React · State, props și re-randări

RangeError: Maximum call stack size exceeded

Pe scurt

O funcție se apelează pe ea însăși la nesfârșit. În React cauza tipică este un handler numit la fel ca setter-ul sau ca funcția pe care o apelează (const setNume = (v) => setNume(v)), sau o componentă care se randează pe ea însăși. Redenumește funcția.

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

Ce înseamnă

Fiecare apel de funcție ocupă un loc pe call stack (stiva de apeluri). Când o funcție se apelează pe ea însăși fără să se oprească, stiva se umple, iar motorul JavaScript aruncă RangeError: Maximum call stack size exceeded.

În codul React recursivitatea este de obicei accidentală:

  • un handler care are același nume ca funcția pe care vrea s-o apeleze (const schimba = (v) => schimba(v), de obicei după o redenumire);
  • o funcție proprie care „acoperă” un setter sau un import cu același nume;
  • un getter/setter de clasă care se citește pe el însuși;
  • un JSON.stringify sau o copiere adâncă pe un obiect care se conține pe el însuși.

Stack trace-ul arată aceeași funcție repetată de multe ori: aceea e funcția de reparat.

De ce apare: cauzele frecvente

1Handler care se apelează pe el însuși

Greșit
JSX
const [nume, setNume] = useState("");
const schimbaNume = (v) => schimbaNume(v.trim());
Corect
JSX
const [nume, setNume] = useState("");
const schimbaNume = (v) => setNume(v.trim());

Handler-ul trebuie să apeleze setter-ul din useState, nu propriul nume.

2Funcție care acoperă un import

Greșit
JSX
import { formateaza } from "./utils";
function formateaza(n) { return formateaza(n) + " lei"; }
Corect
JSX
import { formateaza } from "./utils";
function formateazaPret(n) { return formateaza(n) + " lei"; }

Cu același nume, funcția locală se apelează pe ea însăși, nu pe cea importată (și oricum ar fi o declarație dublă).

3Recursivitate fără caz de oprire

Greșit
JSX
function Meniu({ items }) {
  return items.map((i) => <Meniu key={i.id} items={items} />);
}
Corect
JSX
function Meniu({ items = [] }) {
  return items.map((i) => <Meniu key={i.id} items={i.copii} />);
}

O componentă recursivă trebuie să coboare la copii, ca lista să devină la un moment dat goală.

Repară tu

Repară eroarea, direct în pagină

Componenta de mai jos dă eroarea „Maximum call stack size exceeded” când scrii în câmpul #nume. Repar-o ca titlul #salut să afișeze „Salut, Ana!” după ce scrii „ Ana ” (cu spații), adică numele fără spațiile de la capete.

Codul care dă eroarea
JSX
import { useState } from "react";

export default function App() {
  const [nume, setNume] = useState("");
  const schimbaNume = (text) => schimbaNume(text.trim());

  return (
    <div>
      <input id="nume" onChange={(e) => schimbaNume(e.target.value)} />
      <h2 id="salut">Salut, {nume}!</h2>
    </div>
  );
}
Indiciu

Handler-ul trebuie să apeleze setter-ul din useState.

Alte forme ale mesajului

  • InternalError: too much recursion
  • Uncaught RangeError: Maximum call stack size exceeded

Cum o eviți pe viitor

  • Dă handler-elor nume care descriu acțiunea (handleSchimbaNume, onNumeChange), diferite de setter (setNume).
  • După o redenumire, verifică ce apelează funcția în interiorul ei.
  • Componentele recursive (arbori, meniuri) trebuie să primească mereu o parte mai mică din date.
  • Când vezi eroarea, citește stack trace-ul: numele repetat e cel vinovat.

Întrebări frecvente

E aceeași eroare ca „Too many re-renders”?

Nu. „Too many re-renders” înseamnă că React randează la nesfârșit; aici o funcție JavaScript se apelează pe ea însăși înainte ca React să mai apuce să randeze.

De ce pagina îngheață o clipă înainte de eroare?

Motorul face zeci de mii de apeluri până se umple stiva. Abia apoi aruncă eroarea, de aceea poate dura puțin.

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.