error TS2540: Cannot assign to 'id' because it is a read-only property.
Încerci să modifici o proprietate marcată readonly (în interfață, în clasă sau prin Readonly<T> / as const). Dacă valoarea trebuie să rămână fixă, creează un obiect nou cu valoarea schimbată; dacă trebuie să se poată modifica, scoate readonly din tip.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
readonly în fața unui câmp înseamnă că se poate seta doar la creare (în literal sau în constructor) și nu se mai poate reatribui după. TS2540 apare la orice obiect.camp = ... pe un astfel de câmp. Același efect au Readonly<T>, as const și proprietățile cu doar getter într-o clasă.
readonly e pus de obicei intenționat: id-uri, numere de cont, configurații, date care vin din stare (React, Redux) și nu trebuie modificate direct. Așa că întrebarea corectă e dacă ai voie să schimbi valoarea. Dacă nu, faci o copie modificată: { ...obiect, camp: valoareNoua }. Dacă da, tipul e prea strict și scoți readonly.
Reține că readonly există doar la compilare: nu blochează nimic la rulare. Pentru blocare reală folosești Object.freeze.
De ce apare: cauzele frecvente
1Modifici un id readonly
interface Cont { readonly iban: string; sold: number }
const c: Cont = { iban: "RO49AAAA1B31007593840000", sold: 100 };
c.iban = "RO00";interface Cont { readonly iban: string; sold: number }
const c: Cont = { iban: "RO49AAAA1B31007593840000", sold: 100 };
c.sold = 150;IBAN-ul nu se schimbă după creare; soldul, da. Modifici doar câmpurile care nu sunt readonly.
2Actualizezi starea în loc s-o copiezi
const stare: Readonly<{ pagina: number }> = { pagina: 1 };
stare.pagina = 2;const stare: Readonly<{ pagina: number }> = { pagina: 1 };
const nouaStare = { ...stare, pagina: 2 };Copia cu spread creează un obiect nou, fără să-l atingă pe cel readonly.
3Obiect marcat as const
const config = { port: 3000 } as const;
config.port = 8080;const config = { port: 3000 };
config.port = 8080;as const face toate câmpurile readonly. Dacă trebuie să le modifici, nu folosi as const.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2540: Cannot assign to 'pret' because it is a read-only property, pentru că produsul din catalog e readonly. Nu scoate readonly: creează un produs nou, cu prețul redus, ca programul să afișeze pe două linii Lampă: 120 lei și Lampă: 96 lei.
interface Produs {
readonly nume: string;
readonly pret: number;
}
const lampa: Produs = { nume: "Lampă", pret: 120 };
const redusa: Produs = lampa;
redusa.pret = lampa.pret * 0.8;
console.log(`${lampa.nume}: ${lampa.pret} lei`);
console.log(`${redusa.nume}: ${redusa.pret} lei`);Lampă: 120 lei Lampă: 96 lei
Indiciu
Construiește un obiect nou cu { ...lampa, pret: ... } în loc să modifici câmpul.
Reparația
interface Produs {
readonly nume: string;
readonly pret: number;
}
const lampa: Produs = { nume: "Lampă", pret: 120 };
const redusa: Produs = { ...lampa, pret: lampa.pret * 0.8 };
console.log(`${lampa.nume}: ${lampa.pret} lei`);
console.log(`${redusa.nume}: ${redusa.pret} lei`);De ce merge
Câmpul pret e readonly, deci după creare nu mai poate fi reatribuit. Mai mult, redusa = lampa nu copia obiectul, ci doar referința: modificarea ar fi schimbat și prețul din catalog. Cu { ...lampa, pret: lampa.pret * 0.8 } construiești un obiect nou, cu câmpurile copiate și prețul înlocuit la creare, unde readonly permite setarea. Catalogul rămâne la 120 de lei, iar produsul redus are 96.
Cum o eviți pe viitor
- Marchează
readonlycâmpurile care identifică obiectul (id, IBAN, cod) și lasă modificabile doar câmpurile care chiar se schimbă. - Pentru stare, lucrează cu copii (
{ ...obj, camp: nou },[...lista, element]) în loc de modificări pe loc. - Folosește
ReadonlyArray<T>saureadonly T[]pentru parametri pe care funcția nu trebuie să-i modifice.
Întrebări frecvente
readonly face obiectul imuabil la rulare?
Nu. E doar o verificare la compilare. În JavaScript-ul generat nu rămâne nimic; pentru imuabilitate la rulare folosești Object.freeze.
Cum diferă de const?
const blochează reatribuirea variabilei (eroarea TS2588). readonly blochează reatribuirea unui câmp. Le poți combina: const c: Readonly<Cont>.
Erori înrudite
error TS2588: Cannot assign to 'total' because it is a constant. Ai declarat variabila cu const și apoi încerci să-i dai altă valoare. Dacă valoarea trebuie să se schimbe (un contor, un total), declar-o cu let; dacă nu, creează o variabilă nouă în loc s-o reatribui. error TS2341: Property 'sold' is private and only accessible within class 'Cont'. Accesezi din afara clasei un câmp sau o metodă marcată private. Folosește metodele publice ale clasei (de exemplu un getter getSold() sau get sold()), sau, dacă accesul extern e chiar necesar, schimbă vizibilitatea în public. error TS2339: Property 'nume' does not exist on type 'Produs'. Accesezi o proprietate pe care tipul obiectului nu o are: interfața Produs nu declară câmpul nume. Fie ai scris greșit numele câmpului, fie lipsește din interfață și trebuie adăugat acolo. Învață TypeScript de la zero, cu exerciții la fiecare lecție
Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
