...
Eroare TypeScript · Obiecte, interfețe și proprietăți

error TS2540: Cannot assign to 'id' because it is a read-only property.

Pe scurt

Î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

Greșit
TypeScript
interface Cont { readonly iban: string; sold: number }
const c: Cont = { iban: "RO49AAAA1B31007593840000", sold: 100 };
c.iban = "RO00";
Corect
TypeScript
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

Greșit
TypeScript
const stare: Readonly<{ pagina: number }> = { pagina: 1 };
stare.pagina = 2;
Corect
TypeScript
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

Greșit
TypeScript
const config = { port: 3000 } as const;
config.port = 8080;
Corect
TypeScript
const config = { port: 3000 };
config.port = 8080;

as const face toate câmpurile readonly. Dacă trebuie să le modifici, nu folosi as const.

Repară tu

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.

Codul care dă eroarea
TypeScript
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`);
După reparație, programul afișează
Lampă: 120 lei
Lampă: 96 lei
Indiciu

Construiește un obiect nou cu { ...lampa, pret: ... } în loc să modifici câmpul.

Cum o eviți pe viitor

  • Marchează readonly câ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> sau readonly 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

← Toate erorile TypeScript

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ță 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.