Readonly-Arrays und unveränderliche Daten

Willkommen

Der readonly-Modifizierer für Arrays

const ids: readonly number[] = [1, 2, 3];
// ids.push(4);   // Error
// ids[0] = 99;   // Error
console.log(ids[0]); // OK — reading is fine

Die generische Form ReadonlyArray<T>

const names: ReadonlyArray<string> = ['Alice', 'Bob'];
// names.push('Charlie'); // Error

Readonly-Arrays aus Funktionen zurückgeben

function getConfig(): readonly string[] {
  return ['host', 'port', 'db'];
}

Unveränderliche Funktionsparameter

function sum(nums: readonly number[]): number {
  return nums.reduce((a, b) => a + b, 0);
  // nums.push(99); // Error inside function
}

as const für Literal-Arrays

const colors = ['red', 'green', 'blue'] as const;
// type: readonly ['red', 'green', 'blue']
// colors.push('yellow'); // Error

Readonly erzeugt kein Deep-Freeze

const users: readonly { name: string }[] = [{ name: 'Alice' }];
// users.push({}); // Error
users[0].name = 'Bob'; // Allowed — object itself is mutable

Tiefgreifende Unveränderlichkeit mit Readonly<T>

type ImmutableUser = Readonly<{ name: string; scores: readonly number[] }>;
const u: ImmutableUser = { name: 'Alice', scores: [90, 85] };
// u.name = 'Bob';       // Error
// u.scores.push(100);  // Error

Zuweisung von veränderlich zu readonly

const ro: readonly number[] = [1, 2];
const mutable: number[] = ro; // Error!

Wann Sie Readonly-Arrays verwenden sollten

Spread erzeugt ein neues veränderliches Array

const base: readonly number[] = [1, 2, 3];
const extended: number[] = [...base, 4]; // new mutable array

Schnelltest

Zusammenfassung