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} />).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
forwardRef(fn) există pentru un singur scop: să-i dea componentei ref-ul trimis de părinte, ca al doilea argument al funcției fn. Dacă funcția are un singur parametru ((props) => ...), React deduce că ai uitat ref-ul și te avertizează.
Rezultatul practic: părintele scrie <CampText ref={camp} />, dar camp.current rămâne null, pentru că nimeni nu a pus ref-ul pe vreun element.
Mai rar, mesajul apare cu trei parametri (de exemplu cineva încearcă să primească și context). Forma corectă are exact doi: (props, ref). Dacă nu ai nevoie deloc de ref, nu folosi forwardRef.
De ce apare: cauzele frecvente
1Parametrul ref lipsește
const Buton = forwardRef((props) => <button {...props} />);const Buton = forwardRef((props, ref) => <button ref={ref} {...props} />);Al doilea parametru este chiar ref-ul de la părinte; fără el, nu ai ce să legi de buton.
2forwardRef folosit fără motiv
const Titlu = forwardRef(({ text }) => <h2>{text}</h2>);function Titlu({ text }) {
return <h2>{text}</h2>;
}Dacă nimeni nu pune un ref pe componentă, o funcție obișnuită este suficientă.
Repară eroarea, direct în pagină
Componenta CampEmail de mai jos e învelită în forwardRef, dar consola arată „forwardRef render functions accept exactly two parameters”, iar butonul #goleste nu poate goli câmpul. Repar-o ca, după ce scrii „ana@ex.ro” în #email și apeși #goleste, câmpul să fie gol, iar #stare să afișeze „Câmp golit”.
import { useRef, useState, forwardRef } from "react";
const CampEmail = forwardRef(function CampEmail(props) {
return <input id="email" type="email" {...props} />;
});
export default function App() {
const camp = useRef(null);
const [stare, setStare] = useState("");
function goleste() {
if (camp.current) {
camp.current.value = "";
setStare("Câmp golit");
}
}
return (
<div>
<CampEmail ref={camp} />
<button id="goleste" onClick={goleste}>Golește</button>
<p id="stare">{stare}</p>
</div>
);
}Indiciu
Funcția din forwardRef primește (props, ref).
Reparația
import { useRef, useState, forwardRef } from "react";
const CampEmail = forwardRef(function CampEmail(props, ref) {
return <input id="email" type="email" ref={ref} {...props} />;
});
export default function App() {
const camp = useRef(null);
const [stare, setStare] = useState("");
function goleste() {
if (camp.current) {
camp.current.value = "";
setStare("Câmp golit");
}
}
return (
<div>
<CampEmail ref={camp} />
<button id="goleste" onClick={goleste}>Golește</button>
<p id="stare">{stare}</p>
</div>
);
}De ce merge
forwardRef îi dă funcției ref-ul ca al doilea argument. Cu un singur parametru, ref-ul era ignorat, camp.current rămânea null, iar goleste nu făcea nimic.
Cu (props, ref) și ref={ref} pe input, React leagă camp.current de câmpul din pagină. Handler-ul poate acum să-i golească valoarea direct, ca la orice câmp necontrolat.
Alte forme ale mesajului
Warning: forwardRef render functions accept exactly two parameters: props and ref. Any additional parameter will be undefined.
Cum o eviți pe viitor
- Scrie
forwardRefmereu cu doi parametri,(props, ref), și folosește imediatrefpe un element. - Dă funcției un nume (
forwardRef(function CampText(props, ref) {...})), ca să apară corect în DevTools și în mesaje. - Nu învelește în
forwardRefcomponentele care nu au nevoie de ref.
Întrebări frecvente
Pot pune ref-ul pe altă componentă, nu pe un element HTML?
Da, dacă și acea componentă folosește forwardRef. Ref-ul trece astfel mai departe până ajunge la un element HTML.
Am nevoie de forwardRef și în React 19?
În React 19 ref vine ca prop obișnuit, deci nu mai e necesar. În React 18, versiunea folosită în curs, este singura cale.
Erori înrudite
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. 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.
