RangeError: Maximum call stack size exceeded
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.stringifysau 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
const [nume, setNume] = useState("");
const schimbaNume = (v) => schimbaNume(v.trim());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
import { formateaza } from "./utils";
function formateaza(n) { return formateaza(n) + " lei"; }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
function Meniu({ items }) {
return items.map((i) => <Meniu key={i.id} items={items} />);
}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ă 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.
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.
Reparația
import { useState } from "react";
export default function App() {
const [nume, setNume] = useState("");
const schimbaNume = (text) => setNume(text.trim());
return (
<div>
<input id="nume" onChange={(e) => schimbaNume(e.target.value)} />
<h2 id="salut">Salut, {nume}!</h2>
</div>
);
}De ce merge
schimbaNume se apela pe ea însăși: fiecare apel făcea încă un apel, fără să se oprească vreodată, până când stiva de apeluri s-a umplut și motorul a aruncat RangeError.
Handler-ul are de făcut un singur lucru: să salveze textul curățat în state. setNume(text.trim()) face exact asta, iar React randează din nou titlul cu numele nou. Numele diferite pentru handler și setter fac greșeala ușor de văzut.
Alte forme ale mesajului
InternalError: too much recursionUncaught 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
Too many re-renders. React limits the number of renders to prevent an infinite loop. Componenta schimbă state-ul chiar în timpul randării, de obicei prin onClick={setDeschis(true)}, care apelează funcția imediat. Dă evenimentului o funcție: onClick={() => setDeschis(true)}. Warning: Maximum update depth exceeded. This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render. Un useEffect setează state la fiecare randare, iar fiecare setare pornește o randare nouă: efectul n-are listă de dependențe sau depinde de ceva recreat la fiecare randare. Pune dependențele corecte sau calculează valoarea fără efect. TypeError: setAprecieri is not a function Variabila pe care o apelezi ca setter nu este o funcție, cel mai des pentru că ai destructurat useState cu acolade ({ x, setX }) în loc de paranteze drepte ([x, setX]), ori setter-ul nu a fost trimis ca prop. Î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.
