...
Eroare React · Regulile hook-urilor

Rendered more hooks than during the previous render.

Pe scurt

Un hook este apelat doar uneori (într-un if, după o condiție sau într-o buclă), așa că la o randare componenta a apelat mai multe hook-uri decât la cea dinainte. Mută toate hook-urile la început, necondiționat.

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

Ce înseamnă

React nu ține hook-urile după nume, ci după ordinea apelurilor: primul useState din componentă este „slotul 1”, al doilea „slotul 2” și așa mai departe. De aceea ordinea și numărul hook-urilor trebuie să fie identice la fiecare randare.

Dacă un hook este într-un if (if (arataDetalii) { useState(1) }), la prima randare condiția e falsă și componenta are, să zicem, un hook; după un click condiția devine adevărată și apare un hook în plus. React vede mai multe hook-uri decât la randarea anterioară și se oprește. De obicei vezi înainte și avertismentul „React has detected a change in the order of Hooks called by App”, cu un tabel al hook-urilor din cele două randări.

Mesajul apare la randarea în care se schimbă condiția, deci de obicei după o acțiune a utilizatorului.

De ce apare: cauzele frecvente

1useState într-un if

Greșit
JSX
const [detalii, setDetalii] = useState(false);
if (detalii) {
  const [cantitate, setCantitate] = useState(1);
}
Corect
JSX
const [detalii, setDetalii] = useState(false);
const [cantitate, setCantitate] = useState(1);

Declarat necondiționat, hook-ul există la fiecare randare; doar afișarea depinde de detalii.

2useEffect după o condiție

Greșit
JSX
if (utilizator) {
  useEffect(() => { document.title = utilizator.nume; }, [utilizator]);
}
Corect
JSX
useEffect(() => {
  if (utilizator) document.title = utilizator.nume;
}, [utilizator]);

Condiția se mută în interiorul efectului; efectul în sine e mereu apelat.

3Hook-uri într-o buclă

Greșit
JSX
for (const p of produse) {
  const [selectat] = useState(false);
}
Corect
JSX
const [selectate, setSelectate] = useState({});

Numărul de produse se poate schimba; un singur state (obiect sau tablou) le ține pe toate.

Repară tu

Repară eroarea, direct în pagină

Butonul #detalii afișează secțiunea de detalii, dar la click componenta aruncă „Rendered more hooks than during the previous render”, pentru că un useState stă într-un if. Repar-o ca după click să apară paragraful #cantitate cu textul „Cantitate: 1”.

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

export default function App() {
  const [detalii, setDetalii] = useState(false);

  if (detalii) {
    const [cantitate] = useState(1);
    return <p id="cantitate">Cantitate: {cantitate}</p>;
  }

  return <button id="detalii" onClick={() => setDetalii(true)}>Detalii</button>;
}
Indiciu

Hook-urile trebuie apelate la fiecare randare, în aceeași ordine.

Alte forme ale mesajului

  • Warning: React has detected a change in the order of Hooks called by App. This will lead to bugs and errors if not fixed. For more information, read the Rules of Hooks: https://reactjs.org/link/rules-of-hooks
  • Error: Rendered more hooks than during the previous render.
  • React Hook "useState" is called conditionally. React Hooks must be called in the exact same order in every component render. react-hooks/rules-of-hooks

Cum o eviți pe viitor

  • Regula de bază: hook-urile se apelează la începutul componentei, mereu în aceeași ordine, niciodată în if, bucle sau după un return.
  • Pune condiția în interiorul hook-ului (în efect) sau în JSX, nu în jurul lui.
  • Dacă o parte din UI are nevoie de propriile hook-uri doar uneori, scoate-o într-o componentă separată și randeaz-o condiționat.
  • ESLint cu react-hooks/rules-of-hooks semnalează imediat hook-urile condiționate.

Întrebări frecvente

De ce React nu folosește numele variabilelor ca să știe ce hook e?

Numele nu există la rulare: useState(1) nu știe în ce variabilă va fi pus rezultatul. Ordinea apelurilor este singura informație sigură, de aceea trebuie să fie fixă.

Pot randa condiționat o componentă care are hook-uri?

Da: {detalii && <Detalii />} e perfect. Hook-urile lui Detalii aparțin propriei componente, care apare sau dispare cu totul.

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.