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.
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 (
createContextla nivelul fișierului este permis, doaruseContextse apelează în componente); - un hook propriu (
useCos) care conțineuseStateș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
import { useState } from "react";
const [tema, setTema] = useState("luminoasa");
export default function App() {
return <p>{tema}</p>;
}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
export const TemaContext = createContext("luminoasa");
const tema = useContext(TemaContext);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
const [cos, setCos] = useState([]);
function Lista() { /* setCos(...) */ }
function Total() { /* cos.length */ }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ă 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.
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.
Reparația
import { useState } from "react";
export default function App() {
const [tema, setTema] = useState("luminoasa");
return (
<div>
<p id="tema">Temă: {tema}</p>
<button id="schimba" onClick={() => setTema(tema === "luminoasa" ? "intunecata" : "luminoasa")}>Schimbă</button>
</div>
);
}De ce merge
Linia cu useState rula o singură dată, la încărcarea fișierului, înainte ca React să randeze vreo componentă. Fără o componentă în curs de randare, React nu avea unde să păstreze starea și a oprit aplicația.
În corpul lui App, useState rulează la fiecare randare a componentei. La prima randare întoarce „luminoasa”, iar după setTema React randează din nou și întoarce noua valoare.
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-hooksReact 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,useEffectsauuseContexttrebuie să fie în corpul unei componente sau al unui hookuse.... - Pentru stări comune, ridică starea în părinte sau folosește Context.
- Ține ESLint cu
react-hooksactiv, 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
Invalid hook call. Hooks can only be called inside of the body of a function component. 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. React Hook "useState" is called in function "contor" that is neither a React function component nor a custom React Hook function. React component names must start with an uppercase letter. React Hook names must start with the word "use". Regula ESLint react-hooks/rules-of-hooks nu recunoaște funcția ca o componentă sau un hook, pentru că numele ei nu începe cu literă mare și nici cu use. Redenumește-o: Contor dacă întoarce JSX și o folosești ca <Contor />, sau useContor dacă e un hook propriu. TypeError: Cannot destructure property 'tema' of 'useContext(...)' as it is undefined. Componenta citește un Context care nu are un Provider deasupra ei, iar createContext() fără valoare implicită dă undefined. Învelește arborele în <TemaContext.Provider value={...}> sau dă contextului o valoare implicită. Î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.
