...
Eroare React · Regulile hook-urilor

React Hook "useState" cannot be called at the top level. React Hooks must be called in a React function component or a custom React Hook function.

Pe scurt

Ai apelat un hook direct în fișier, în afara oricărei funcții, de obicei pentru o stare „globală”. Hook-urile funcționează doar în timpul randării unei componente: mută apelul în corpul componentei. Pentru o stare comună mai multor componente, folosește Context sau o stare ridicată în părinte.

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

Ce înseamnă

Codul de la nivelul fișierului (în afara funcțiilor) rulează o singură dată, când modulul e importat, înainte ca React să randeze ceva. Un hook are nevoie de o componentă în curs de randare căreia să-i atașeze starea; la nivelul fișierului nu există niciuna.

Regula ESLint react-hooks/rules-of-hooks semnalează asta direct. La rulare, React 18 afișează „Invalid hook call” și apoi TypeError: Cannot read properties of null (reading 'useState'), pentru că mecanismul intern care gestionează hook-urile este null în afara randării.

De obicei greșeala vine din dorința de a avea o stare comună: „pun useState sus, ca să-l folosească toate componentele”. Soluțiile corecte sunt:

  • o stare în componenta părinte comună, trimisă prin props;
  • un Context (createContext la nivelul fișierului este permis, doar useContext se apelează în componente);
  • un hook propriu (useCos) care conține useState și e apelat în componente.

Valorile constante (care nu se schimbă) pot sta liniștite la nivelul fișierului, ca simple const.

De ce apare: cauzele frecvente

1Stare „globală” la nivelul fișierului

Greșit
JSX
import { useState } from "react";

const [tema, setTema] = useState("luminoasa");

export default function App() {
  return <p>{tema}</p>;
}
Corect
JSX
import { useState } from "react";

export default function App() {
  const [tema, setTema] = useState("luminoasa");
  return <p>{tema}</p>;
}

În corpul lui App, hook-ul rulează la fiecare randare și are o componentă căreia să-i aparțină.

2useContext apelat lângă createContext

Greșit
JSX
export const TemaContext = createContext("luminoasa");
const tema = useContext(TemaContext);
Corect
JSX
export const TemaContext = createContext("luminoasa");

function Antet() {
  const tema = useContext(TemaContext);
  return <header className={tema}>Magazin</header>;
}

createContext se poate apela oriunde, dar useContext doar în componentele care citesc valoarea.

3Stare comună pentru mai multe componente

Greșit
JSX
const [cos, setCos] = useState([]);
function Lista() { /* setCos(...) */ }
function Total() { /* cos.length */ }
Corect
JSX
function App() {
  const [cos, setCos] = useState([]);
  return (
    <>
      <Lista onAdauga={(p) => setCos([...cos, p])} />
      <Total numar={cos.length} />
    </>
  );
}

Starea ridicată în părintele comun ajunge la copii prin props și rămâne într-un singur loc.

Repară tu

Repară eroarea, direct în pagină

Fișierul de mai jos apelează useState direct la nivelul fișierului și dă „Invalid hook call” la pornire (ESLint: „React Hook "useState" cannot be called at the top level”). Repară-l ca #tema să afișeze „Temă: luminoasa” la început și „Temă: intunecata” după click pe #schimba.

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

const [tema, setTema] = useState("luminoasa");

export default function App() {
  return (
    <div>
      <p id="tema">Temă: {tema}</p>
      <button id="schimba" onClick={() => setTema(tema === "luminoasa" ? "intunecata" : "luminoasa")}>Schimbă</button>
    </div>
  );
}
Indiciu

Mută linia cu useState în corpul lui App.

Alte forme ale mesajului

  • React Hook "useEffect" cannot be called at the top level. 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 at the top level.
  • TypeError: Cannot read properties of null (reading 'useState')
  • TypeError: Cannot read properties of null (reading 'useContext')

Cum o eviți pe viitor

  • La nivelul fișierului pune doar importuri, constante, funcții și createContext; niciodată hook-uri.
  • Fiecare useState, useEffect sau useContext trebuie să fie în corpul unei componente sau al unui hook use....
  • Pentru stări comune, ridică starea în părinte sau folosește Context.
  • Ține ESLint cu react-hooks activ, ca să vezi problema înainte de rulare.

Întrebări frecvente

De ce primesc „Cannot read properties of null (reading 'useState')”?

Pentru că hook-ul rulează când React nu randează nimic. Intern, obiectul care gestionează hook-urile este null în acel moment, iar useState încearcă să-l folosească.

Pot folosi o variabilă simplă la nivelul fișierului în loc de state?

Pentru constante, da. Pentru valori care se schimbă și trebuie afișate, nu: React nu știe când s-a schimbat variabila și nu 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.