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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Hook-urile (useState, useEffect...) pot fi apelate doar în două feluri de funcții: componente și hook-uri proprii. ESLint nu poate ști ce face o funcție, așa că se uită la nume:
- o componentă începe cu literă mare (
Contor,CardProdus); - un hook propriu începe cu use urmat de literă mare (
useContor,useFetch).
Când un hook e apelat într-o funcție cu alt nume (contor, getDate, afiseazaLista), regula react-hooks/rules-of-hooks raportează această eroare. Nu e doar o chestiune de stil: o funcție obișnuită poate fi apelată condiționat, într-o buclă sau dintr-un handler, iar atunci hook-urile din ea își schimbă ordinea între randări.
O capcană în plus: o componentă cu nume mic, folosită ca tag (<contor />), e tratată de React ca un tag HTML necunoscut, nu ca o componentă. Literă mare pentru componente, use pentru hook-uri, și ambele probleme dispar.
De ce apare: cauzele frecvente
1Hook propriu fără prefixul use
function contor(start) {
const [n, setN] = useState(start);
return [n, () => setN(n + 1)];
}function useContor(start) {
const [n, setN] = useState(start);
return [n, () => setN(n + 1)];
}Cu use la început, ESLint știe că funcția e un hook și verifică regulile și acolo unde e apelată.
2Componentă cu literă mică
function cardProdus({ nume }) {
const [deschis, setDeschis] = useState(false);
return <h3 onClick={() => setDeschis(!deschis)}>{nume}</h3>;
}function CardProdus({ nume }) {
const [deschis, setDeschis] = useState(false);
return <h3 onClick={() => setDeschis(!deschis)}>{nume}</h3>;
}Componentele trebuie să înceapă cu literă mare, atât pentru ESLint, cât și pentru JSX (<CardProdus />).
3Hook într-o funcție ajutătoare din componentă
function App() {
function citesteTema() {
return useContext(TemaContext);
}
const tema = citesteTema();
}function App() {
const tema = useContext(TemaContext);
}Apelează hook-ul direct în corpul componentei; funcțiile interioare nu sunt componente.
Repară eroarea, direct în pagină
Codul de mai jos merge, dar ESLint îl oprește cu „React Hook "useState" is called in function "contor" that is neither a React function component nor a custom React Hook function”. Transformă contor într-un hook propriu, cu numele corect, ca butonul #plus să afișeze 1 la început și 3 după două click-uri.
import { useState } from "react";
function contor(start) {
const [n, setN] = useState(start);
return [n, () => setN(n + 1)];
}
export default function App() {
const [n, creste] = contor(1);
return <button id="plus" onClick={creste}>{n}</button>;
}Indiciu
Un hook propriu se numește use + literă mare: useContor.
Reparația
import { useState } from "react";
function useContor(start) {
const [n, setN] = useState(start);
return [n, () => setN(n + 1)];
}
export default function App() {
const [n, creste] = useContor(1);
return <button id="plus" onClick={creste}>{n}</button>;
}De ce merge
Regula hook-urilor recunoaște componentele după literă mare și hook-urile după prefixul use. contor nu era nici una, nici alta, așa că ESLint nu putea garanta că useState din ea e apelat mereu în aceeași ordine.
Redenumită useContor, funcția e un hook propriu: ESLint verifică acum și locul unde e apelată (direct în App, nu într-un if). Comportamentul rămâne același: starea pornește de la 1 și crește la fiecare click.
Alte forme ale mesajului
React Hook "useEffect" is called in function "incarcaDate" 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". react-hooks/rules-of-hooksReact Hook "useState" is called in function "app" that is neither a React function component nor a custom React Hook function.React Hook "useContext" is called in function "getTema" 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".
Cum o eviți pe viitor
- Numește componentele cu literă mare (PascalCase) și hook-urile proprii cu
use+ literă mare. - Apelează hook-urile doar la începutul corpului unei componente sau al unui hook, nu în funcții ajutătoare.
- Activează în editor
eslint-plugin-react-hooks(e în șabloanele Vite și Next.js), ca să vezi greșeala pe loc. - Dacă o funcție nu folosește hook-uri, n-are nevoie de
useîn nume.
Întrebări frecvente
Codul merge. De ce contează numele?
Merge cât timp funcția e apelată la fiecare randare, în aceeași ordine. Numele use... îi permite lui ESLint să verifice că așa rămâne. Fără el, o mutare a apelului într-un if strică aplicația fără niciun avertisment.
Trebuie să pun hook-urile proprii în fișiere separate?
Nu e obligatoriu, dar e util când le refolosești. Important e doar numele: useCos, useFetch, useLocalStorage.
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. Warning: The tag <produs> is unrecognized in this browser. If you meant to render a React component, start its name with an uppercase letter. Ai folosit o componentă al cărei nume începe cu literă mică, iar React a tratat-o ca pe un tag HTML necunoscut. Numele componentelor încep mereu cu literă mare: Produs, nu produs. 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. Î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.
