...
Eroare React · State, props și re-randări

TypeError: Cannot assign to read only property 'titlu' of object '#<Object>'

Pe scurt

Componenta încearcă să modifice un prop (props.titlu = ...). În React props-urile sunt doar pentru citire; calculează valoarea nouă într-o variabilă locală sau cere părintelui s-o schimbe.

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

Ce înseamnă

React îngheață obiectul props (cu Object.freeze) în modul de dezvoltare, tocmai ca să prindă greșeala asta. Orice atribuire de tipul props.titlu = ... aruncă Cannot assign to read only property 'titlu', unde numele dintre ghilimele este prop-ul pe care ai încercat să-l modifici.

Regula din spate: props-urile aparțin părintelui. Componenta copil le primește ca date de intrare și le folosește, dar nu le schimbă. Dacă vrei să afișezi o variantă transformată, o calculezi într-o variabilă nouă. Dacă vrei ca valoarea să se schimbe cu adevărat (de exemplu la un click), părintele ține state-ul și trimite copilului un callback.

Aceeași eroare poate apărea și la obiectele înghețate în alt fel, de exemplu datele dintr-un store care nu permite modificări directe.

De ce apare: cauzele frecvente

1Transformarea unui prop pe loc

Greșit
JSX
function Banner(props) {
  props.titlu = props.titlu.toUpperCase();
  return <h2>{props.titlu}</h2>;
}
Corect
JSX
function Banner({ titlu }) {
  const titluMare = titlu.toUpperCase();
  return <h2>{titluMare}</h2>;
}

Variabila locală e a componentei și poate primi orice valoare; prop-ul rămâne neatins.

2Schimbarea unui prop la un eveniment

Greșit
JSX
function Cantitate(props) {
  return <button onClick={() => { props.valoare += 1; }}>+</button>;
}
Corect
JSX
function Cantitate({ valoare, onSchimba }) {
  return <button onClick={() => onSchimba(valoare + 1)}>+</button>;
}

Copilul cere schimbarea, iar părintele o face în state-ul lui; apoi trimite noua valoare ca prop.

Repară tu

Repară eroarea, direct în pagină

Componenta Banner modifică prop-ul titlu ca să-l afișeze cu majuscule și aruncă „Cannot assign to read only property 'titlu'”. Repar-o fără să modifici props: h2-ul trebuie să afișeze „OFERTA ZILEI”.

Codul care dă eroarea
JSX
function Banner(props) {
  props.titlu = props.titlu.toUpperCase();
  return <h2>{props.titlu}</h2>;
}

export default function App() {
  return <Banner titlu="Oferta zilei" />;
}
Indiciu

Calculează textul cu majuscule într-o variabilă nouă.

Alte forme ale mesajului

  • TypeError: Cannot assign to read only property 'children' of object '#<Object>'
  • TypeError: "titlu" is read-only
  • TypeError: Cannot add property cantitate, object is not extensible

Cum o eviți pe viitor

  • Tratează props-urile ca pe parametrii unei funcții pure: le citești, nu le scrii.
  • Destructurează props-urile în semnătură (function Banner({ titlu })) și creează variabile noi pentru valorile derivate.
  • Când un copil trebuie să schimbe o valoare, trimite-i un callback din părinte.

Întrebări frecvente

În producție nu primesc eroarea. Pot lăsa așa?

Nu. Înghețarea props-urilor există doar în dezvoltare ca să te avertizeze. În producție modificarea „trece”, dar React nu știe de ea, iar valoarea se pierde la următoarea randare a părintelui.

Pot modifica un obiect primit ca prop, de exemplu props.produs.pret = 10?

Obiectul din interior nu este înghețat, deci nu primești eroarea, dar e aceeași greșeală: modifici datele părintelui pe ascuns. Creează o copie: { ...produs, pret: 10 }.

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.