TypeError: Cannot read properties of undefined (reading 'value')
Codul citește e.target.value, dar e.target (sau e) este undefined. De obicei handler-ul primește deja valoarea, nu evenimentul: o componentă proprie sau o bibliotecă apelează onChange(valoare). Folosește direct parametrul (onChange={(valoare) => setNume(valoare)}) sau citește valoarea din locul corect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
e.target.value presupune că e este un eveniment al unui câmp: e.target e inputul, iar .value textul din el. Eroarea „reading 'value'” spune că obiectul dinaintea lui .value (adică e.target) e undefined.
Situația tipică: o componentă proprie, Camp, apelează onChange(e.target.value), deci trimite părintelui textul, nu evenimentul. Părintele scrie însă, din obișnuință, onChange={(e) => setNume(e.target.value)}. Aici e e un string, "A".target e undefined, iar .value aruncă eroarea la prima literă scrisă.
La fel se întâmplă cu multe biblioteci de componente (selecturi, date pickers, sliders), care trimit direct valoarea sau un obiect { value, label }. Alte cauze: un ref neatașat (ref.current e undefined sau null), un handler apelat manual, fără argument, ori un e.target citit asincron. Citește documentația sau semnătura componentei: ce primește callback-ul ei?
De ce apare: cauzele frecvente
1Componenta proprie trimite valoarea, nu evenimentul
function Camp({ onChange }) {
return <input onChange={(e) => onChange(e.target.value)} />;
}
<Camp onChange={(e) => setNume(e.target.value)} />function Camp({ onChange }) {
return <input onChange={(e) => onChange(e.target.value)} />;
}
<Camp onChange={(valoare) => setNume(valoare)} />Părintele primește deja textul, deci îl folosește direct.
2Bibliotecă cu altă semnătură
<SelectOras onChange={(e) => setOras(e.target.value)} />
// SelectOras apelează onChange({ value: "cluj", label: "Cluj" })<SelectOras onChange={(optiune) => setOras(optiune.value)} />Callback-ul primește opțiunea aleasă, cu câmpul value, nu un eveniment DOM.
3Ref care nu e atașat
const emailRef = useRef();
<input />
console.log(emailRef.current.value);const emailRef = useRef(null);
<input ref={emailRef} />
// în handler: console.log(emailRef.current.value);Fără ref={emailRef}, current rămâne gol, iar .value nu are de unde fi citit.
Repară eroarea, direct în pagină
Componenta Camp de mai jos trimite părintelui direct textul scris. Părintele îl tratează ca pe un eveniment și, la prima literă, apare „TypeError: Cannot read properties of undefined (reading 'value')”. Repară codul din App ca după ce scrii „Ana” în #nume, #salut să afișeze „Salut, Ana!”.
import { useState } from "react";
function Camp({ onChange }) {
return <input id="nume" onChange={(e) => onChange(e.target.value)} />;
}
export default function App() {
const [nume, setNume] = useState("");
return (
<div>
<Camp onChange={(e) => setNume(e.target.value)} />
<p id="salut">Salut, {nume}!</p>
</div>
);
}Indiciu
Callback-ul primește deja valoarea: (valoare) => setNume(valoare).
Reparația
import { useState } from "react";
function Camp({ onChange }) {
return <input id="nume" onChange={(e) => onChange(e.target.value)} />;
}
export default function App() {
const [nume, setNume] = useState("");
return (
<div>
<Camp onChange={(valoare) => setNume(valoare)} />
<p id="salut">Salut, {nume}!</p>
</div>
);
}De ce merge
Camp apela onChange(e.target.value), deci părintele primea textul, nu evenimentul. În App, e.target pe un text era undefined, iar citirea .value arunca eroarea.
Callback-ul (valoare) => setNume(valoare) folosește direct ce trimite Camp. La fiecare literă, starea primește textul complet din input, iar salutul se actualizează.
Alte forme ale mesajului
TypeError: Cannot read properties of undefined (reading 'target')TypeError: undefined is not an object (evaluating 'e.target.value')TypeError: can't access property "value", e.target is undefinedTypeError: Cannot read property 'value' of undefined
Cum o eviți pe viitor
- Când creezi o componentă de formular, decide clar ce trimite
onChange: evenimentul sau valoarea, și păstrează aceeași convenție peste tot. - Dă parametrului un nume care spune ce e:
(valoare) =>sau(e) =>. - La componente din biblioteci, verifică în documentație ce primește callback-ul.
- Un
console.log(e)la începutul handler-ului îți arată imediat ce primești.
Întrebări frecvente
De ce merge pe un input simplu și nu pe componenta mea?
Un <input> nativ trimite evenimentul, deci e.target.value e corect. Componenta ta trimite doar textul. Codul părintelui trebuie să urmeze ce trimite componenta.
E mai bine ca o componentă proprie să trimită evenimentul sau valoarea?
Ambele variante sunt folosite. Trimiterea valorii e mai simplă pentru părinte; trimiterea evenimentului imită inputul nativ. Important e să fie aceeași convenție în tot proiectul.
Erori înrudite
ReferenceError: e is not defined Folosești e.target.value într-un handler care nu primește parametrul e: onChange={() => setNume(e.target.value)}. Declară parametrul: onChange={(e) => setNume(e.target.value)}. TypeError: Cannot read properties of undefined (reading 'preventDefault') Handler-ul tău apelează e.preventDefault(), dar e este undefined: ai scris onSubmit={trimite()} (funcția rulează la randare, fără eveniment) sau ai apelat trimite() din alt loc, fără argument. Dă-i lui React funcția, nu rezultatul ei: onSubmit={trimite} sau onClick={(e) => trimite(e)}. 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ă. Î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.
