Что такое `readonly` в TypeScript?

Что такое readonly

readonly — ключевое слово TypeScript, которое помечает свойство объекта или элемент массива как доступный только для чтения. После инициализации значение нельзя переприсвоить — компилятор выдаст ошибку.

interface User {
  readonly id: number;
  name: string;
}

const user: User = { id: 1, name: 'Иван' };
user.name = 'Пётр'; // OK
user.id = 2;        // Ошибка: Cannot assign to 'id' because it is a read-only property

Применение в классах

readonly можно использовать в свойствах класса. Присваивание разрешено только в объявлении или в конструкторе.

class Order {
  readonly createdAt: Date;

  constructor() {
    this.createdAt = new Date(); // OK — присваивание в конструкторе разрешено
  }

  reset() {
    this.createdAt = new Date(); // Ошибка: свойство readonly
  }
}

ReadonlyArray и readonly для массивов

Для массивов readonly запрещает мутирующие методы (push, pop, splice и т.д.).

const nums: readonly number[] = [1, 2, 3];
nums.push(4);   // Ошибка: Property 'push' does not exist on type 'readonly number[]'
nums[0] = 99;   // Ошибка: Index signature in type 'readonly number[]' only permits reading

Утилитный тип Readonly<T>

TypeScript предоставляет встроенный mapped type Readonly<T>, который делает все свойства типа T доступными только для чтения.

interface Config {
  host: string;
  port: number;
}

const config: Readonly<Config> = {
  host: 'localhost',
  port: 3000,
};

config.host = 'prod.example.com'; // Ошибка: свойство read-only

Важное ограничение: только поверхностная защита

readonly действует не рекурсивно — он защищает только прямое переприсваивание ссылки, но не вложенные объекты.

interface Company {
  readonly address: { city: string };
}

const company: Company = { address: { city: 'Москва' } };
company.address = { city: 'Питер' }; // Ошибка
company.address.city = 'Питер';      // OK — TypeScript это разрешает

Для глубокой неизменяемости используют рекурсивные утилитные типы или библиотеки типа type-fest.

readonly — только типовая проверка

Важно понимать: readonly существует только на уровне TypeScript. После компиляции в JavaScript никаких ограничений на изменение объекта нет. Если нужна реальная неизменяемость в рантайме — используйте Object.freeze().