TypeError: Cannot read properties of null (reading 'focus')
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ânddeschise î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
const ref = useRef(null);
useEffect(() => {
ref.current.focus();
}, []);
return deschis && <input ref={ref} />;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
function Cautare() {
const ref = useRef(null);
ref.current.focus();
return <input ref={ref} />;
}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
function Camp(props) {
return <input {...props} />;
}
<Camp ref={ref} />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ă 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.
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.
Reparația
import { useState, useRef, useEffect } from "react";
export default function App() {
const [deschis, setDeschis] = useState(false);
const ref = useRef(null);
useEffect(() => {
if (deschis) {
ref.current.focus();
}
}, [deschis]);
return (
<div>
<button id="deschide" onClick={() => setDeschis(true)}>Caută</button>
{deschis && <input id="cautare" ref={ref} />}
</div>
);
}De ce merge
Efectul cu [] rula o singură dată, la montare, când deschis era false și inputul nu exista. React nu completase ref-ul, deci ref.current era null, iar .focus() arunca eroarea.
Cu dependența [deschis], efectul rulează și după click. Atunci inputul e deja în DOM, ref.current îl indică, iar condiția if (deschis) evită apelul la pornire.
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
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 .... 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. Function components cannot have string refs. We recommend using useRef() instead. 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. Î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.
