...
Eroare React · Regulile hook-urilor

Warning: forwardRef render functions accept exactly two parameters: props and ref. Did you forget to use the ref parameter?

Pe scurt

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

Greșit
JSX
const Buton = forwardRef((props) => <button {...props} />);
Corect
JSX
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

Greșit
JSX
const Titlu = forwardRef(({ text }) => <h2>{text}</h2>);
Corect
JSX
function Titlu({ text }) {
  return <h2>{text}</h2>;
}

Dacă nimeni nu pune un ref pe componentă, o funcție obișnuită este suficientă.

Repară tu

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

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

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 forwardRef mereu cu doi parametri, (props, ref), și folosește imediat ref pe 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 forwardRef componentele 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

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