Warning: Function components cannot be given refs. Attempts to access this ref will fail. Did you mean to use React.forwardRef()?
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ă
function CampText(props) {
return <input {...props} />;
}
<CampText ref={camp} />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
function CampText({ ref, ...rest }) {
return <input ref={ref} {...rest} />;
}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ă 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”.
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.
Reparația
import { useRef, useState, forwardRef } from "react";
const CampText = forwardRef(function CampText(props, ref) {
return <input id="camp" ref={ref} {...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>
);
}De ce merge
Pe o componentă funcție, React 18 nu are unde să pună ref-ul, deci camp.current rămâne null, iar codul din handler nu se execută niciodată.
forwardRef îi dă componentei ref-ul ca al doilea argument, după props. Componenta îl pune pe input, iar React leagă camp.current de nodul DOM al câmpului. Acum camp.current.focus() funcționează, iar mesajul de stare apare.
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,
refse poate primi direct ca prop; în React 18 (versiunea din curs) ai nevoie deforwardRef.
Î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
Warning: forwardRef render functions accept exactly two parameters: props and ref. Did you forget to use the ref parameter? Funcția dată lui forwardRef are un singur parametru (props), deci ref-ul primit nu e folosit. Adaugă al doilea parametru, ref, și pune-l pe elementul HTML din componentă: forwardRef((props, ref) => <input ref={ref} {...props} />). Warning: Rand: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. Componenta încearcă să citească props.key, dar key este rezervat pentru React și nu ajunge niciodată în props. Trimite valoarea printr-un prop separat, de exemplu id={p.id} sau cod={p.cod}. TypeError: Cannot read properties of null (reading 'nume') Citești un câmp dintr-un obiect care încă este null, de obicei date care se încarcă în useEffect, dar sunt afișate deja la prima randare. Afișează o stare de încărcare până vin datele: if (!utilizator) return .... Î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.
