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

error TS2542: Index signature in type 'readonly number[]' only permits reading.

Pe scurt

Încerci să modifici un element dintr-un tablou readonly (sau dintr-un obiect cu index signature readonly): lista[0] = .... Creează o copie ([...lista]) și modific-o pe aceea, sau construiește un tablou nou cu map.

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

Ce înseamnă

readonly number[] (sau ReadonlyArray<number>) este un tablou pe care codul tău promite să nu-l modifice. Poți citi lista[0], dar nu poți scrie lista[0] = 5. „Index signature” se referă la accesul prin paranteze pătrate ([i]), iar mesajul spune că acesta permite doar citirea.

De obicei tabloul e readonly intenționat: e un parametru al unei funcții care nu trebuie să modifice datele primite, o constantă declarată cu as const sau o proprietate readonly dintr-un tip de stare (de exemplu în React sau Redux). Pe același tablou, metodele care modifică (push, sort, splice) dau TS2339, pentru că nu există pe tipul readonly.

Reparația corectă e aproape mereu să lucrezi pe o copie: const copie = [...lista] sau lista.map(...), care produce un tablou nou. Să scoți readonly din tip ar ascunde problema pe care tipul o semnala.

De ce apare: cauzele frecvente

1Modificare directă a parametrului

Greșit
TypeScript
function dubleaza(xs: readonly number[]) {
  for (let i = 0; i < xs.length; i++) xs[i] *= 2;
  return xs;
}
Corect
TypeScript
function dubleaza(xs: readonly number[]) {
  return xs.map((x) => x * 2);
}

map construiește un tablou nou, iar originalul rămâne neatins.

2Constantă as const

Greșit
TypeScript
const zile = ["L", "Ma", "Mi"] as const;
zile[0] = "Luni";
Corect
TypeScript
const zile = ["L", "Ma", "Mi"] as const;
const zileLungi = ["Luni", ...zile.slice(1)];

as const face tabloul readonly; creezi o variantă nouă cu valoarea schimbată.

3Obiect cu index readonly

Greșit
TypeScript
const preturi: { readonly [k: string]: number } = { pix: 3 };
preturi["pix"] = 4;
Corect
TypeScript
const preturi: { readonly [k: string]: number } = { pix: 3 };
const noi = { ...preturi, pix: 4 };

Și obiectele cu index signature readonly se actualizează prin copiere.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2542: Index signature in type 'readonly number[]' only permits reading. Rescrie funcția cuReducere ca să întoarcă un tablou nou, fără să modifice parametrul, iar programul să afișeze 90,180 și apoi 100,200.

Codul care dă eroarea
TypeScript
function cuReducere(preturi: readonly number[]): number[] {
  const rezultat = preturi as number[];
  for (let i = 0; i < preturi.length; i++) {
    preturi[i] = preturi[i] * 0.9;
  }
  return rezultat;
}
const lista = [100, 200];
console.log(cuReducere(lista).join(","));
console.log(lista.join(","));
După reparație, programul afișează
90,180
100,200
Indiciu

Întoarce preturi.map(...) în loc să modifici elementele în buclă.

Alte forme ale mesajului

  • error TS2542: Index signature in type 'readonly string[]' only permits reading.
  • error TS2542: Index signature in type 'Readonly<Record<string, number>>' only permits reading.

Cum o eviți pe viitor

  • Marchează parametrii readonly când funcția nu trebuie să modifice datele și lucrează pe copii.
  • Folosește metode care produc tablouri noi: map, filter, slice, concat, spread [...xs].
  • Pentru sortare fără modificare, scrie [...xs].sort(...).
  • Nu elimina readonly doar ca să treacă codul; înseamnă că modifici date pe care alt cod nu se așteaptă să le schimbi.

Întrebări frecvente

readonly oprește modificarea și la rulare?

Nu. readonly există doar la compilare. Dacă ai nevoie de protecție și la rulare, folosește Object.freeze, care are și tipul readonly potrivit.

De ce push dă alt mesaj?

Pe readonly number[] metodele care modifică pur și simplu nu există, deci xs.push(1) dă TS2339 (Property 'push' does not exist on type 'readonly number[]'). TS2542 e doar pentru scrierea prin indice.

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.