TypeError: Cannot add property eticheta, object is not extensible
Încerci să adaugi o proprietate nouă pe un obiect înghețat: în React, de obicei pe props (props.eticheta = "Nou") sau pe un obiect din state ori din Redux/Immer. Props-urile sunt doar de citit: pune valoarea într-o variabilă locală (const eticheta = props.eticheta ?? "Nou") sau folosește un parametru implicit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un obiect „not extensible” nu mai acceptă proprietăți noi: a fost înghețat cu Object.freeze sau Object.preventExtensions. În modul strict (cum sunt toate modulele JavaScript), încercarea de a-i adăuga ceva aruncă TypeError.
În React, în modul de dezvoltare, obiectul props al fiecărui element este înghețat, ca să nu-l modifici din greșeală. De aceea props.eticheta = "Nou" într-o componentă aruncă exact această eroare, dacă eticheta nu era deja în props. Dacă proprietatea exista, mesajul este cel înrudit: „Cannot assign to read only property”.
Alte locuri unde apare:
- obiecte din Redux Toolkit sau Immer, înghețate după actualizare;
- datele importate dintr-un modul care le-a înghețat;
- obiectele primite din biblioteci care își protejează starea.
Regula e aceeași: nu modifica obiectul primit; creează o valoare nouă (o variabilă locală sau o copie { ...obiect, camp: valoare }).
De ce apare: cauzele frecvente
1Valoare implicită scrisă în props
function Card(props) {
if (!props.eticheta) {
props.eticheta = "Nou";
}
return <span>{props.eticheta}</span>;
}function Card({ eticheta = "Nou" }) {
return <span>{eticheta}</span>;
}Parametrul implicit creează o variabilă locală; obiectul props rămâne neatins.
2Câmp nou adăugat pe un obiect din props
function Produs({ produs }) {
produs.cuTva = produs.pret * 1.19;
return <p>{produs.cuTva}</p>;
}function Produs({ produs }) {
const cuTva = produs.pret * 1.19;
return <p>{cuTva}</p>;
}Dacă obiectul e înghețat (de exemplu vine din Redux), nu i se pot adăuga câmpuri; o variabilă calculată nu are această problemă.
3Obiect înghețat modificat direct
const setari = Object.freeze({ tema: "luminoasa" });
setari.limba = "ro";const setari = Object.freeze({ tema: "luminoasa" });
const setariNoi = { ...setari, limba: "ro" };Copia creată cu spread este un obiect nou, care se poate extinde.
Repară eroarea, direct în pagină
Cardurile de mai jos dau „TypeError: Cannot add property eticheta, object is not extensible”, pentru că Card scrie în props. Repar-o fără să modifici props, ca primul card să afișeze „Cană (Nou)”, iar al doilea „Ceainic (Reducere)”.
function Card(props) {
if (!props.eticheta) {
props.eticheta = "Nou";
}
return <p className="card">{props.nume} ({props.eticheta})</p>;
}
export default function App() {
return (
<div>
<Card nume="Cană" />
<Card nume="Ceainic" eticheta="Reducere" />
</div>
);
}Indiciu
Folosește un parametru implicit: function Card({ nume, eticheta = "Nou" }).
Reparația
function Card({ nume, eticheta = "Nou" }) {
return <p className="card">{nume} ({eticheta})</p>;
}
export default function App() {
return (
<div>
<Card nume="Cană" />
<Card nume="Ceainic" eticheta="Reducere" />
</div>
);
}De ce merge
În modul de dezvoltare, React îngheață obiectul props. Primul card nu primea eticheta, iar props.eticheta = "Nou" încerca să adauge o proprietate nouă pe un obiect înghețat, ceea ce aruncă TypeError.
Parametrul implicit eticheta = "Nou" creează o variabilă locală: are valoarea primită, dacă există, altfel „Nou”. Props-urile rămân neschimbate, iar fiecare card afișează eticheta potrivită.
Alte forme ale mesajului
TypeError: Cannot add property 0, object is not extensibleTypeError: can't define property "eticheta": Object is not extensibleTypeError: Attempted to assign to readonly property.TypeError: Cannot define property eticheta, object is not extensible
Cum o eviți pe viitor
- Tratează props-urile ca fiind doar de citit: nu le atribui nimic.
- Valorile implicite pune-le în parametrii componentei (
{ eticheta = "Nou" }). - Valorile derivate (cu TVA, formatate) calculează-le în variabile locale.
- Pentru obiecte din state sau Redux, creează copii (
{ ...obiect, camp }) în loc să le modifici.
Întrebări frecvente
De ce merge în producție și pică doar în dezvoltare?
React îngheață props-urile doar în build-ul de dezvoltare, tocmai ca să prindă greșeala. În producție atribuirea „merge”, dar e tot o greșeală: modifici date care nu-ți aparțin.
Care e diferența față de „Cannot assign to read only property”?
Ambele vin din obiecte protejate. „Cannot add property” apare când adaugi un câmp nou, iar „Cannot assign to read only property” când schimbi unul care există deja.
Erori înrudite
TypeError: Cannot assign to read only property 'titlu' of object '#<Object>' 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. Warning: Card: Support for defaultProps will be removed from function components in a future major release. Use JavaScript default parameters instead. Componenta funcție Card folosește Card.defaultProps, pe care React 18.3 îl marchează ca învechit (în React 19 nu mai funcționează pentru funcții). Scoate defaultProps și pune valorile implicite direct în parametri: function Card({ nume = "Anonim", pret = 0 }). TypeError: Assignment to constant variable. Încerci să schimbi direct o variabilă declarată cu const, de obicei valoarea din useState (cantitate = cantitate + 1). State-ul se schimbă doar prin setter: setCantitate(c => c + 1). Î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.
