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

error TS4104: The type 'readonly number[]' is 'readonly' and cannot be assigned to the mutable type 'number[]'.

Pe scurt

Dai un tablou readonly unei variabile sau funcții care așteaptă un tablou modificabil (number[]). Marchează și parametrul ca readonly number[] sau lucrează pe o copie: [...lista].

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

Ce înseamnă

readonly number[] (sau ReadonlyArray<number>) e un tablou fără metodele care îl modifică: nu are push, pop, sort, splice, iar lista[0] = 1 e interzis. Un number[] obișnuit le are pe toate. Dacă ai voie să pui un tablou readonly într-o variabilă number[], oricine ar putea să-l modifice prin acea variabilă, deci garanția s-ar pierde. De aceea TypeScript refuză conversia.

Cel mai des vezi mesajul ca detaliu al unui TS2345, când dai tabloul ca argument: Argument of type 'readonly number[]' is not assignable to parameter of type 'number[]', urmat de rândul cu TS4104. Sursa tablourilor readonly: as const, Readonly<...>, parametri declarați readonly, proprietăți readonly din tipuri.

Reparația depinde de funcție: dacă nu modifică tabloul, schimbă-i parametrul în readonly number[] (acceptă și tablouri normale). Dacă îl modifică, dă-i o copie.

De ce apare: cauzele frecvente

1Funcția nu modifică tabloul, dar cere number[]

Greșit
TypeScript
function suma(l: number[]) { return l.reduce((a, b) => a + b, 0); }
const note: readonly number[] = [9, 7];
suma(note);
Corect
TypeScript
function suma(l: readonly number[]) { return l.reduce((a, b) => a + b, 0); }
const note: readonly number[] = [9, 7];
suma(note);

Un parametru readonly acceptă și tablouri obișnuite, și readonly. E tipul potrivit pentru funcțiile care doar citesc.

2Funcția chiar modifică tabloul

Greșit
TypeScript
function sorteaza(l: number[]) { return l.sort(); }
const note = [9, 7] as const;
sorteaza(note);
Corect
TypeScript
function sorteaza(l: number[]) { return l.sort(); }
const note = [9, 7] as const;
sorteaza([...note]);

Copia [...note] e un tablou nou, modificabil, iar originalul rămâne neatins.

3Atribuire directă

Greșit
TypeScript
const fix: readonly string[] = ['a'];
const lista: string[] = fix;
Corect
TypeScript
const fix: readonly string[] = ['a'];
const lista: string[] = [...fix];

Copiezi elementele într-un tablou nou, pe care îl poți modifica liber.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS4104: The type 'readonly number[]' is 'readonly' and cannot be assigned to the mutable type 'number[]'. Funcția doar citește notele. Repară-o ca programul să afișeze Media: 8.

Codul care dă eroarea
TypeScript
function media(note: number[]): number {
  return note.reduce((a, b) => a + b, 0) / note.length;
}
const noteElev: readonly number[] = [9, 7, 8];
const lista: number[] = noteElev;
console.log(`Media: ${media(lista)}`);
După reparație, programul afișează
Media: 8
Indiciu

Schimbă tipul parametrului, nu tabloul.

Alte forme ale mesajului

  • error TS2345: Argument of type 'readonly number[]' is not assignable to parameter of type 'number[]'.
  • error TS4104: The type 'readonly string[]' is 'readonly' and cannot be assigned to the mutable type 'string[]'.
  • error TS4104: The type 'readonly ["S", "M", "L"]' is 'readonly' and cannot be assigned to the mutable type 'string[]'.

Cum o eviți pe viitor

  • Scrie parametrii funcțiilor care doar citesc ca readonly T[]: funcțiile devin compatibile cu orice tablou.
  • Pentru sortare fără modificare folosește [...lista].sort() sau lista.toSorted() (ES2023).
  • Când folosești as const, ține minte că rezultatul e readonly.
  • Dacă o bibliotecă cere T[] și tu ai un tablou readonly, dă-i o copie, nu forța tipul cu as.

Întrebări frecvente

De ce merge invers, number[] la readonly number[]?

Un tablou modificabil are tot ce are unul readonly, plus metode în plus. Dacă îl tratezi ca readonly, doar renunți la ele, deci e sigur. Invers ai câștiga metode pe care nu ai voie să le folosești.

readonly oprește modificarea și la rulare?

Nu. readonly există doar la compilare. Dacă vrei protecție și la rulare, folosește Object.freeze(lista), care face tabloul imposibil de modificat.

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.