...
Eroare React · Regulile hook-urilor

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".

Pe scurt

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

Greșit
JSX
function contor(start) {
  const [n, setN] = useState(start);
  return [n, () => setN(n + 1)];
}
Corect
JSX
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ă

Greșit
JSX
function cardProdus({ nume }) {
  const [deschis, setDeschis] = useState(false);
  return <h3 onClick={() => setDeschis(!deschis)}>{nume}</h3>;
}
Corect
JSX
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ă

Greșit
JSX
function App() {
  function citesteTema() {
    return useContext(TemaContext);
  }
  const tema = citesteTema();
}
Corect
JSX
function App() {
  const tema = useContext(TemaContext);
}

Apelează hook-ul direct în corpul componentei; funcțiile interioare nu sunt componente.

Repară tu

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.

Codul care dă eroarea
JSX
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.

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-hooks
  • React 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

← 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.