...
Eroare React · Regulile hook-urilor

TypeError: Cannot read properties of null (reading 'focus')

Pe scurt

ref.current este încă null când apelezi ref.current.focus(): elementul nu e montat (e afișat condiționat, încă nu s-a randat sau ref-ul nu e legat de el). Folosește ref-ul doar după montare, în useEffect, verifică if (ref.current) și leagă-l cu ref={ref} pe elementul care există.

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

Ce înseamnă

useRef(null) creează un obiect { current: null }. React pune elementul DOM în ref.current după ce îl adaugă în pagină și îl readuce la null când elementul dispare. Dacă citești ref.current.focus() (sau .scrollIntoView(), .value, .play()) când elementul nu există, current e null și apare această eroare.

Situațiile tipice:

  • folosești ref-ul în timpul randării, înainte ca elementul să fie în DOM;
  • elementul e afișat condiționat ({deschis && <input ref={ref} />}), iar efectul rulează când deschis e încă false;
  • ai uitat ref={ref} pe element sau l-ai pus pe o componentă proprie care nu îl transmite mai departe;
  • un handler rulează după ce elementul a fost scos din pagină.

Stiva de apeluri îți arată linia cu ref.current.... Întreabă-te în acel moment: elementul este afișat?

De ce apare: cauzele frecvente

1Element afișat condiționat

Greșit
JSX
const ref = useRef(null);
useEffect(() => {
  ref.current.focus();
}, []);
return deschis && <input ref={ref} />;
Corect
JSX
const ref = useRef(null);
useEffect(() => {
  if (deschis) ref.current.focus();
}, [deschis]);
return deschis && <input ref={ref} />;

Efectul rulează din nou când deschis devine true, iar atunci inputul există și ref-ul e completat.

2Ref folosit în timpul randării

Greșit
JSX
function Cautare() {
  const ref = useRef(null);
  ref.current.focus();
  return <input ref={ref} />;
}
Corect
JSX
function Cautare() {
  const ref = useRef(null);
  useEffect(() => {
    ref.current.focus();
  }, []);
  return <input ref={ref} />;
}

La randare elementul nu e încă în DOM; efectele rulează după ce React l-a adăugat.

3Ref neajuns la element

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

În React 18, ref nu ajunge în props-urile unei componente funcție; cu forwardRef îl transmiți inputului.

Repară tu

Repară eroarea, direct în pagină

Câmpul de căutare de mai jos apare doar după click pe #deschide, iar la pornire pagina dă „TypeError: Cannot read properties of null (reading 'focus')”. Repar-o ca pagina să pornească fără eroare, iar după click câmpul #cautare să apară și să primească focus automat.

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

export default function App() {
  const [deschis, setDeschis] = useState(false);
  const ref = useRef(null);

  useEffect(() => {
    ref.current.focus();
  }, []);

  return (
    <div>
      <button id="deschide" onClick={() => setDeschis(true)}>Caută</button>
      {deschis && <input id="cautare" ref={ref} />}
    </div>
  );
}
Indiciu

Fă focus în efect doar când câmpul e afișat și adaugă condiția în dependențe.

Alte forme ale mesajului

  • TypeError: Cannot read properties of null (reading 'scrollIntoView')
  • TypeError: Cannot read properties of undefined (reading 'focus')
  • TypeError: null is not an object (evaluating 'ref.current.focus')
  • TypeError: can't access property "focus", ref.current is null

Cum o eviți pe viitor

  • Citește ref-urile către elemente doar în efecte și în handler-e, niciodată în corpul componentei.
  • Pentru elemente afișate condiționat, pune condiția în efect și adaug-o în dependențe.
  • Folosește optional chaining când nu ești sigur: ref.current?.focus().
  • Pentru focus la montare pe un input simplu poți folosi și atributul autoFocus.

Întrebări frecvente

De ce ref.current e null deși văd inputul în pagină?

Probabil ref-ul e citit înainte de randarea care l-a afișat (de exemplu în efectul de la montare, când inputul încă era ascuns) sau ref={ref} e pe altă componentă care nu îl transmite.

Pot folosi useState în loc de useRef pentru element?

Da, cu un callback ref: ref={setElement}. Componenta se randează din nou când elementul apare, iar un efect cu [element] rulează exact atunci. E util când elementul apare și dispare des.

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.