...
Eroare React · Regulile hook-urilor

Invalid hook call. Hooks can only be called inside of the body of a function component.

Pe scurt

Ai apelat un hook (useState, useEffect, useContext...) în afara corpului unei componente funcție: într-un handler, într-o funcție obișnuită sau într-o clasă. Mută apelul la începutul componentei.

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

Ce înseamnă

Hook-urile funcționează doar când React randează o componentă: în acel moment știe „a cui” este fiecare useState. Dacă apelezi un hook în altă parte, React nu are nicio componentă activă de care să-l lege și aruncă Invalid hook call.

Mesajul complet listează trei motive posibile: versiuni diferite de react și react-dom, încălcarea regulilor hook-urilor și două copii de React în același proiect. La începători, aproape mereu este al doilea: hook-ul este apelat într-un handler (onClick), într-o funcție ajutătoare care nu e componentă sau custom hook, într-o componentă clasă ori într-o funcție apelată direct, ca {Card()}.

Primele două motive apar în proiectele locale, după un npm install greșit sau când o bibliotecă aduce propria versiune de React; npm ls react îți arată câte copii ai.

De ce apare: cauzele frecvente

1Hook apelat într-un handler

Greșit
JSX
function adaugaInCos() {
  const [buc, setBuc] = useState(0);
  setBuc(buc + 1);
}
Corect
JSX
const [buc, setBuc] = useState(0);
function adaugaInCos() {
  setBuc((b) => b + 1);
}

State-ul se declară o singură dată, la nivelul componentei; handler-ul doar îl schimbă.

2Hook într-o funcție ajutătoare obișnuită

Greșit
JSX
function citesteTema() {
  return useContext(TemaContext);
}
Corect
JSX
function useTema() {
  return useContext(TemaContext);
}

O funcție care folosește hook-uri devine custom hook: numele începe cu use și se apelează doar din componente.

3Hook într-o componentă clasă

Greșit
JSX
class Profil extends Component {
  render() {
    const [deschis] = useState(false);
    ...
  }
}
Corect
JSX
function Profil() {
  const [deschis] = useState(false);
  ...
}

Componentele clasă folosesc this.state; hook-urile merg doar în componente funcție.

Repară tu

Repară eroarea, direct în pagină

Butonul #adauga ar trebui să crească numărul de produse din #cos („Produse în coș: 0”), dar la click aruncă „Invalid hook call”. Repară componenta ca după două click-uri #cos să afișeze „Produse în coș: 2”.

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

export default function App() {
  function adaugaInCos() {
    const [buc, setBuc] = useState(0);
    setBuc(buc + 1);
  }

  return (
    <div>
      <p id="cos">Produse în coș: 0</p>
      <button id="adauga" onClick={adaugaInCos}>Adaugă</button>
    </div>
  );
}
Indiciu

Unde trebuie declarat state-ul: în handler sau în componentă?

Alte forme ale mesajului

  • Error: Invalid hook call. Hooks can only be called inside of the body of a function component. This could happen for one of the following reasons: 1. You might have mismatching versions of React and the renderer (such as React DOM) 2. You might be breaking the Rules of Hooks 3. You might have more than one copy of React in the same app
  • Warning: Invalid hook call. Hooks can only be called inside of the body of a function component.
  • TypeError: Cannot read properties of null (reading 'useState')

Cum o eviți pe viitor

  • Declară toate hook-urile la începutul componentei, înainte de orice if, buclă sau funcție internă.
  • Numește funcțiile care folosesc hook-uri cu prefixul use și apelează-le doar din componente sau din alte hook-uri.
  • Activează ESLint cu eslint-plugin-react-hooks: regula rules-of-hooks prinde aceste greșeli în editor.
  • Dacă codul pare corect, rulează npm ls react ca să vezi dacă ai două copii de React.

Întrebări frecvente

Eroarea apare doar când dau click. De ce?

Pentru că hook-ul este în handler, iar handler-ul rulează abia la click. Randarea inițială nu ajunge la acel cod.

Am verificat codul și hook-urile sunt la locul lor. Ce mai poate fi?

Două copii de React (de exemplu o bibliotecă legată local cu npm link) sau versiuni diferite de react și react-dom. Aliniază versiunile în package.json și reinstalează dependențele.

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.