...
Eroare React · Regulile hook-urilor

Warning: Function components cannot be given refs. Attempts to access this ref will fail. Did you mean to use React.forwardRef()?

Pe scurt

Ai pus ref={...} pe o componentă funcție a ta, nu pe un element HTML. În React 18 ref nu ajunge în props, deci ref.current rămâne null. Învelește componenta în forwardRef și pune ref-ul primit pe elementul HTML din interior.

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

Ce înseamnă

Un ref (useRef) îți dă acces direct la un nod din DOM, de exemplu ca să pui focus pe un câmp. Pe elementele HTML (<input ref={camp} />) funcționează direct. Pe o componentă funcție proprie (<CampText ref={camp} />) însă, React 18 nu are unde să-l pună: o funcție nu are o instanță, iar ref nu este transmis prin props.

De aceea React te avertizează că orice acces la acest ref va eșua: camp.current rămâne null, iar camp.current.focus() aruncă „Cannot read properties of null”.

Soluția este forwardRef: componenta primește ref ca al doilea argument și îl pune pe elementul HTML potrivit. Mesajul spune și unde e problema („Check the render method of App”): componenta părinte care a pus ref.

De ce apare: cauzele frecvente

1ref pe o componentă funcție obișnuită

Greșit
JSX
function CampText(props) {
  return <input {...props} />;
}
<CampText ref={camp} />
Corect
JSX
const CampText = forwardRef(function CampText(props, ref) {
  return <input ref={ref} {...props} />;
});
<CampText ref={camp} />

forwardRef îi dă componentei ref-ul ca al doilea argument, iar ea îl leagă de input.

2Citire din props.ref

Greșit
JSX
function CampText({ ref, ...rest }) {
  return <input ref={ref} {...rest} />;
}
Corect
JSX
function CampText({ campRef, ...rest }) {
  return <input ref={campRef} {...rest} />;
}
<CampText campRef={camp} />

În React 18 ref nu e un prop; dacă nu vrei forwardRef, trimite ref-ul sub alt nume.

Repară tu

Repară eroarea, direct în pagină

Componenta de mai jos vrea să pună focus pe câmpul de căutare la click pe #cauta, dar ref-ul e pus pe componenta CampText, iar consola arată „Function components cannot be given refs”. Repar-o ca, după click, câmpul #camp să primească focus, iar #stare să afișeze „Focus pe căutare”.

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

function CampText(props) {
  return <input id="camp" {...props} />;
}

export default function App() {
  const camp = useRef(null);
  const [stare, setStare] = useState("");

  function pornesteCautarea() {
    if (camp.current) {
      camp.current.focus();
      setStare("Focus pe căutare");
    }
  }

  return (
    <div>
      <CampText ref={camp} placeholder="Caută" />
      <button id="cauta" onClick={pornesteCautarea}>Caută</button>
      <p id="stare">{stare}</p>
    </div>
  );
}
Indiciu

Învelește CampText în forwardRef și pune ref-ul pe input.

Alte forme ale mesajului

  • Warning: Function components cannot be given refs. Attempts to access this ref will fail. Did you mean to use React.forwardRef()? Check the render method of `App`.

Cum o eviți pe viitor

  • Pune ref-uri direct pe elemente HTML ori de câte ori poți.
  • Componentele de tip câmp, buton sau modal pe care părintele trebuie să le controleze se scriu din start cu forwardRef.
  • Dacă folosești React 19, ref se poate primi direct ca prop; în React 18 (versiunea din curs) ai nevoie de forwardRef.

Întrebări frecvente

Merge pe componente clasă?

Da: pe o clasă, ref-ul primește instanța clasei (nu nodul DOM). Avertismentul apare doar pentru componente funcție.

De ce am apoi „Cannot read properties of null (reading 'focus')”?

Pentru că ref-ul nu a fost legat de niciun element, deci camp.current a rămas null. Repară avertismentul și eroarea dispare.

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.