...
Eroare React · Regulile hook-urilor

React Hook "useState" may be executed more than once. Possibly because it is called in a loop. React Hooks must be called in the exact same order in every component render.

Pe scurt

Ai pus un hook într-o buclă (for, while). Când numărul de pași se schimbă între randări, React pierde ordinea hook-urilor și dă „Rendered more hooks than during the previous render”. Ține toate valorile într-o singură stare (un tablou sau un obiect) ori creează o componentă pentru fiecare element.

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

Ce înseamnă

Regula react-hooks/rules-of-hooks a găsit un hook într-o buclă. React identifică fiecare hook al unei componente după poziția lui în ordinea apelurilor: primul useState, al doilea, al treilea. Într-o buclă, numărul de apeluri depinde de date, de exemplu de lungimea unei liste.

Cât timp lista are mereu aceeași lungime, codul pare să meargă. Când adaugi sau ștergi un element, componenta apelează alt număr de hook-uri decât la randarea anterioară, iar React aruncă Rendered more hooks than during the previous render (sau „fewer”) și afișează avertismentul „React has detected a change in the order of Hooks”.

Două reparații, după caz:

  • o singură stare pentru toată colecția: useState([1, 1]) sau useState({ cana: 1, ceainic: 1 }), modificată cu copii noi;
  • o componentă pe element: fiecare rând își are propriul useState, iar lista doar face map peste componente, cu key.

De ce apare: cauzele frecvente

1Stare pentru fiecare produs într-un for

Greșit
JSX
const cantitati = [];
for (const p of produse) {
  const [c, setC] = useState(1);
  cantitati.push(c);
}
Corect
JSX
const [cantitati, setCantitati] = useState({});
// cantitatea unui produs: cantitati[p.id] ?? 1

O singură stare, un obiect cu câte o valoare pe produs, nu depinde de numărul de produse.

2Componentă pentru fiecare element

Greșit
JSX
for (let i = 0; i < intrebari.length; i++) {
  const [raspuns, setRaspuns] = useState("");
}
Corect
JSX
function Intrebare({ text }) {
  const [raspuns, setRaspuns] = useState("");
  return <input value={raspuns} onChange={(e) => setRaspuns(e.target.value)} />;
}
// {intrebari.map((t) => <Intrebare key={t} text={t} />)}

Fiecare Intrebare are exact un useState, iar lista poate crește sau scădea fără probleme.

3Hook-uri într-un while

Greșit
JSX
let i = 0;
while (i < pagini) {
  useEffect(() => incarcaPagina(i), []);
  i++;
}
Corect
JSX
useEffect(() => {
  for (let i = 0; i < pagini; i++) {
    incarcaPagina(i);
  }
}, [pagini]);

Bucla se mută în interiorul unui singur efect; efectul în sine e apelat o dată pe randare.

Repară tu

Repară eroarea, direct în pagină

Coșul de mai jos ține cantitățile cu câte un useState într-o buclă for. Când apeși pe #adauga, apare „Rendered more hooks than during the previous render”. Repar-o cu o singură stare pentru cantități, ca după click să fie 3 produse în listă, iar al treilea să fie „Farfurie x 1”.

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

export default function App() {
  const [produse, setProduse] = useState(["Cană", "Ceainic"]);

  const cantitati = [];
  for (let i = 0; i < produse.length; i++) {
    const [c] = useState(1);
    cantitati.push(c);
  }

  return (
    <div>
      <button id="adauga" onClick={() => setProduse([...produse, "Farfurie"])}>Adaugă farfurie</button>
      <ul>
        {produse.map((p, i) => (
          <li key={p}>{p} x {cantitati[i]}</li>
        ))}
      </ul>
    </div>
  );
}
Indiciu

Ține cantitățile într-un obiect în state și citește cantitati[nume] ?? 1.

Alte forme ale mesajului

  • React Hook "useState" may be executed more than once. Possibly because it is called in a loop. React Hooks must be called in the exact same order in every component render. react-hooks/rules-of-hooks
  • React Hook "useRef" may be executed more than once. Possibly because it is called in a loop.
  • React Hook "useEffect" may be executed more than once. Possibly because it is called in a loop. React Hooks must be called in the exact same order in every component render.

Cum o eviți pe viitor

  • Nu pune hook-uri în for, while, forEach sau map: scrie-le doar la începutul componentei.
  • Pentru valori pe element, folosește un tablou sau un obiect în state, actualizat cu copii.
  • Când fiecare element are logică proprie (stare, efecte), creează o componentă pentru el.
  • Testează lista adăugând și ștergând elemente: așa apar erorile de ordine a hook-urilor.

Întrebări frecvente

Lista mea are mereu 3 elemente. Pot lăsa bucla?

Ar merge, dar regula te oprește pe bună dreptate: la prima schimbare de cerințe (un element în plus), aplicația pică. Un tablou în state e la fel de simplu și sigur.

Cum modific o singură valoare dintr-un obiect în state?

Cu o copie: setCantitati({ ...cantitati, [id]: noua }). React vede un obiect nou și randează din nou.

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.