...
Eroare React · Regulile hook-urilor

Rendered fewer hooks than expected. This may be caused by an accidental early return statement.

Pe scurt

Componenta are un return înainte de unele hook-uri, așa că la anumite randări iese mai devreme și apelează mai puține hook-uri. Mută toate hook-urile deasupra oricărui return condiționat.

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

Ce înseamnă

Mesajul îți spune chiar și cauza: an accidental early return statement, un return care oprește funcția înainte să ajungă la toate hook-urile. Exemplu tipic: if (!logat) return <Login />; urmat, mai jos, de useState sau useEffect.

La randarea în care condiția e falsă, componenta trece de return și apelează toate hook-urile. La randarea în care condiția devine adevărată, iese devreme și sare peste ultimele hook-uri. Cum React identifică hook-urile după ordine și număr, vede că lipsesc unele și aruncă eroarea.

Este perechea erorii „Rendered more hooks than during the previous render”: aceeași regulă încălcată, doar că acum numărul de hook-uri scade în loc să crească.

De ce apare: cauzele frecvente

1Return devreme înaintea unui hook

Greșit
JSX
const [logat, setLogat] = useState(false);
if (logat) return <p>Bun venit!</p>;
const [email, setEmail] = useState("");
Corect
JSX
const [logat, setLogat] = useState(false);
const [email, setEmail] = useState("");
if (logat) return <p>Bun venit!</p>;

Toate hook-urile se apelează înainte de primul return condiționat.

2Return pentru starea de încărcare

Greșit
JSX
if (seIncarca) return <p>Se încarcă...</p>;
useEffect(() => { document.title = "Produse"; }, []);
Corect
JSX
useEffect(() => { document.title = "Produse"; }, []);
if (seIncarca) return <p>Se încarcă...</p>;

Efectul este înregistrat la fiecare randare, iar starea de încărcare se tratează după el.

Repară tu

Repară eroarea, direct în pagină

Formularul de autentificare de mai jos are un return devreme pentru utilizatorul logat, pus înaintea unui useState. La click pe #intra aruncă „Rendered fewer hooks than expected”. Repară ordinea ca după click să apară mesajul #bun-venit („Bun venit!”).

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

export default function App() {
  const [logat, setLogat] = useState(false);

  if (logat) {
    return <p id="bun-venit">Bun venit!</p>;
  }

  const [email, setEmail] = useState("");

  return (
    <div>
      <input id="email" value={email} onChange={(e) => setEmail(e.target.value)} />
      <button id="intra" onClick={() => setLogat(true)}>Intră</button>
    </div>
  );
}
Indiciu

Toate hook-urile trebuie să fie deasupra lui if (logat) return ...

Alte forme ale mesajului

  • Error: Rendered fewer hooks than expected. This may be caused by an accidental early return statement.
  • React Hook "useState" is called conditionally. React Hooks must be called in the exact same order in every component render. Did you accidentally call a React Hook after an early return?

Cum o eviți pe viitor

  • Ordinea într-o componentă: întâi toate hook-urile, apoi calculele, apoi return-urile condiționate, apoi JSX-ul final.
  • Dacă o ramură are nevoie de hook-uri proprii, scoate-o într-o componentă separată.
  • react-hooks/rules-of-hooks din ESLint semnalează hook-urile apelate după un return condiționat.
  • Când adaugi un hook nou într-o componentă existentă, pune-l lângă celelalte, sus, nu acolo unde ai nevoie de valoare.

Întrebări frecvente

Pot avea mai multe return-uri într-o componentă?

Da, cât timp toate apar după hook-uri. return-urile devreme sunt un tipar obișnuit pentru încărcare sau erori, doar că se pun sub ultimul hook.

De ce eroarea apare abia după un click?

Pentru că abia atunci condiția din if se schimbă și componenta iese mai devreme. Prima randare apelează toate hook-urile, deci trece fără probleme.

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.