...
Eroare React · Regulile hook-urilor

React Hook "useState" cannot be called inside a callback. React Hooks must be called in a React function component or a custom React Hook function.

Pe scurt

Ai apelat un hook într-o funcție transmisă mai departe: un handler (onClick), callback-ul din map, filter, setTimeout sau useEffect. Hook-urile se apelează doar direct în corpul componentei; declară starea sus și doar folosește setter-ul în callback. Pentru fiecare element dintr-un map, creează o componentă separată.

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

Ce înseamnă

Regula react-hooks/rules-of-hooks vede un hook apelat într-o funcție-săgeată sau într-o funcție anonimă dată ca argument: onClick={() => { useState(...) }}, lista.map(() => useState(...)), useEffect(() => { useContext(...) }).

De ce e interzis: React ține evidența hook-urilor unei componente după ordinea în care sunt apelate la randare. Un callback se poate apela de zero, una sau de mai multe ori, sau mai târziu, la un click, când React nu mai randează nimic. La rulare, rezultatul e de obicei „Invalid hook call” (hook apelat în afara randării) sau „Rendered more hooks than during the previous render” (număr diferit de hook-uri între randări).

Soluțiile tipice:

  • starea folosită de un handler se declară sus, în componentă, iar în handler doar o modifici cu setter-ul;
  • pentru elementele unei liste, fiecare cu starea lui, creezi o componentă pentru un element și o folosești în map;
  • datele dintr-un context se citesc cu useContext în componentă, apoi se folosesc în efect.

De ce apare: cauzele frecvente

1useState într-un handler

Greșit
JSX
function App() {
  function trimite() {
    const [trimis, setTrimis] = useState(false);
    setTrimis(true);
  }
  return <button onClick={trimite}>Trimite</button>;
}
Corect
JSX
function App() {
  const [trimis, setTrimis] = useState(false);
  function trimite() {
    setTrimis(true);
  }
  return <button onClick={trimite}>Trimite</button>;
}

Hook-ul e apelat la fiecare randare, în corpul componentei; handler-ul doar schimbă starea.

2Stare pentru fiecare element din map

Greșit
JSX
{produse.map((p) => {
  const [cant, setCant] = useState(1);
  return <li key={p.id}>{p.nume} x {cant}</li>;
})}
Corect
JSX
function RandProdus({ produs }) {
  const [cant, setCant] = useState(1);
  return <li>{produs.nume} x {cant}</li>;
}
// ...
{produse.map((p) => <RandProdus key={p.id} produs={p} />)}

Fiecare RandProdus este o componentă cu propriile hook-uri, oricâte elemente ar avea lista.

3Hook în efect

Greșit
JSX
useEffect(() => {
  const tema = useContext(TemaContext);
  document.body.className = tema;
}, []);
Corect
JSX
const tema = useContext(TemaContext);
useEffect(() => {
  document.body.className = tema;
}, [tema]);

Valoarea din context se citește în componentă, iar efectul o primește ca dependență.

Repară tu

Repară eroarea, direct în pagină

Butonul de mai jos dă „Invalid hook call” la click, iar ESLint spune „React Hook "useState" cannot be called inside a callback”. Repar-o ca, după click pe #trimite, paragraful #mesaj să afișeze „Mesaj trimis”, iar butonul să devină dezactivat.

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

export default function App() {
  const [mesaj, setMesaj] = useState("");

  function trimite() {
    const [trimis, setTrimis] = useState(false);
    setTrimis(true);
    setMesaj("Mesaj trimis");
  }

  return (
    <div>
      <button id="trimite" onClick={trimite} disabled={mesaj !== ""}>Trimite</button>
      <p id="mesaj">{mesaj}</p>
    </div>
  );
}
Indiciu

Mută useState în corpul componentei; în handler doar apelează setter-ul.

Alte forme ale mesajului

  • React Hook "useEffect" cannot be called inside a callback. React Hooks must be called in a React function component or a custom React Hook function. react-hooks/rules-of-hooks
  • React Hook "useContext" cannot be called inside a callback.
  • React Hook "useState" cannot be called in a class component. React Hooks must be called in a React function component or a custom React Hook function.
  • React Hook "useState" cannot be called in an async function.

Cum o eviți pe viitor

  • Scrie toate hook-urile la începutul componentei, înainte de orice funcție, if sau return.
  • În handler-e și efecte folosește doar valorile și setter-ele declarate sus.
  • Când fiecare element dintr-o listă are nevoie de stare proprie, scoate-l într-o componentă separată.
  • Lasă eslint-plugin-react-hooks activ: prinde greșeala înainte să rulezi codul.

Întrebări frecvente

La rulare primesc „Invalid hook call”. E aceeași problemă?

Da. Un hook apelat dintr-un handler rulează la click, în afara randării, iar React nu are nicio componentă căreia să-i atribuie starea. ESLint îți arată cauza, iar „Invalid hook call” este efectul ei.

Pot crea o stare nouă la fiecare click?

Nu ca hook. Ține o listă în state și adaugă elemente în ea la click: setElemente([...elemente, 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.