...
Eroare React · Formulare și câmpuri controlate

TypeError: Cannot read properties of undefined (reading 'value')

Pe scurt

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

Greșit
JSX
function Camp({ onChange }) {
  return <input onChange={(e) => onChange(e.target.value)} />;
}
<Camp onChange={(e) => setNume(e.target.value)} />
Corect
JSX
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ă

Greșit
JSX
<SelectOras onChange={(e) => setOras(e.target.value)} />
// SelectOras apelează onChange({ value: "cluj", label: "Cluj" })
Corect
JSX
<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

Greșit
JSX
const emailRef = useRef();
<input />
console.log(emailRef.current.value);
Corect
JSX
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ă tu

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

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

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 undefined
  • TypeError: 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

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