...
Eroare React · Regulile hook-urilor

Function components cannot have string refs. We recommend using useRef() instead.

Pe scurt

Ai scris ref="camp" (un text) pe un element dintr-o componentă funcție. Ref-urile text sunt o funcție veche a componentelor clasă (this.refs.camp). Creează un ref cu const campRef = useRef(null), pune ref={campRef} și folosește campRef.current.

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

Ce înseamnă

În componentele clasă vechi se putea scrie <input ref="camp" /> și apoi this.refs.camp. Acestea sunt ref-uri text (string refs): învechite de mult și eliminate în React 19. O componentă funcție nu are this și nici this.refs, așa că React refuză ref-ul text și aruncă această eroare la randare.

Varianta corectă în funcții este useRef:

  • const campRef = useRef(null); creează un obiect { current: null } care rămâne același între randări;
  • <input ref={campRef} /> (între acolade, fără ghilimele) îi spune lui React să pună elementul în campRef.current;
  • în efecte și handler-e citești campRef.current.value, campRef.current.focus() etc.

Mesajul complet continuă cu un link către documentație („Learn more about using refs safely here”). Dacă eroarea vine dintr-o bibliotecă veche, singura soluție este o versiune nouă a ei.

De ce apare: cauzele frecvente

1Ref text într-o componentă funcție

Greșit
JSX
function Cautare() {
  return <input ref="camp" />;
}
Corect
JSX
function Cautare() {
  const campRef = useRef(null);
  return <input ref={campRef} />;
}

useRef dă un obiect, iar ref={campRef} îl leagă de element; textul "camp" nu are unde să fie salvat.

2Cod copiat dintr-o componentă clasă

Greșit
JSX
function Formular() {
  function trimite() {
    alert(this.refs.email.value);
  }
  return <input ref="email" />;
}
Corect
JSX
function Formular() {
  const emailRef = useRef(null);
  function trimite() {
    alert(emailRef.current.value);
  }
  return <input ref={emailRef} />;
}

În funcții nu există this.refs; valoarea se citește din emailRef.current.

3Ref text într-o clasă (învechit)

Greșit
JSX
class Camp extends React.Component {
  render() {
    return <input ref="input" />;
  }
}
Corect
JSX
class Camp extends React.Component {
  inputRef = React.createRef();
  render() {
    return <input ref={this.inputRef} />;
  }
}

În clase, varianta modernă este createRef; ref-urile text dau avertismente în StrictMode și nu mai există în React 19.

Repară tu

Repară eroarea, direct în pagină

Formularul de mai jos dă „Function components cannot have string refs. We recommend using useRef() instead.”. Repară-l cu useRef, ca după ce scrii „Ana” în #nume și apeși pe #salut, paragraful #mesaj să afișeze „Salut, Ana!”.

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

export default function App() {
  const [mesaj, setMesaj] = useState("");

  function saluta() {
    setMesaj("Salut, " + this.refs.nume.value + "!");
  }

  return (
    <div>
      <input id="nume" ref="nume" />
      <button id="salut" onClick={saluta}>Salută</button>
      <p id="mesaj">{mesaj}</p>
    </div>
  );
}
Indiciu

const numeRef = useRef(null); apoi ref={numeRef} și numeRef.current.value.

Alte forme ale mesajului

  • Error: Function components cannot have string refs. We recommend using useRef() instead. Learn more about using refs safely here: https://reactjs.org/link/strict-mode-string-ref
  • Warning: A string ref, "camp", has been found within a strict mode tree. String refs are a source of potential bugs and should be avoided. We recommend using useRef() or createRef() instead.
  • Warning: Component "Camp" contains the string ref "input". Support for string refs will be removed in a future major release. We recommend using useRef() or createRef() instead.

Cum o eviți pe viitor

  • În componente funcție folosește doar useRef și ref={numeRef}, între acolade.
  • Numește ref-urile clar (emailRef, listaRef), ca să nu le confunzi cu valorile din state.
  • Când copiezi cod vechi, caută this.refs și ref="..." și înlocuiește-le.
  • Pentru câmpuri de formular, de cele mai multe ori un input controlat (value + onChange) e mai simplu decât un ref.

Întrebări frecvente

De ce scrie „We recommend using useRef()”, nu createRef?

createRef creează un obiect nou la fiecare apel, deci într-o funcție s-ar pierde la fiecare randare. useRef păstrează același obiect pe toată durata componentei.

Când am nevoie de ref, de fapt?

Pentru acțiuni directe asupra unui element: focus, derulare, măsurare, redare video, integrarea cu o bibliotecă non-React. Pentru valori afișate, folosește state.

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.