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

TypeError: Cannot add property eticheta, object is not extensible

Pe scurt

Î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

Greșit
JSX
function Card(props) {
  if (!props.eticheta) {
    props.eticheta = "Nou";
  }
  return <span>{props.eticheta}</span>;
}
Corect
JSX
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

Greșit
JSX
function Produs({ produs }) {
  produs.cuTva = produs.pret * 1.19;
  return <p>{produs.cuTva}</p>;
}
Corect
JSX
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

Greșit
JSX
const setari = Object.freeze({ tema: "luminoasa" });
setari.limba = "ro";
Corect
JSX
const setari = Object.freeze({ tema: "luminoasa" });
const setariNoi = { ...setari, limba: "ro" };

Copia creată cu spread este un obiect nou, care se poate extinde.

Repară tu

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

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

Alte forme ale mesajului

  • TypeError: Cannot add property 0, object is not extensible
  • TypeError: can't define property "eticheta": Object is not extensible
  • TypeError: 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

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