Модификаторы свойств

Принципы

• Отображаемые типы позволяют массово изменять модификаторы: делать свойства nullable, optional, readonly, required.
• Стандартные утилиты (Partial, Readonly, Required) решают большинство кейсов без ручного объявления.
• Проверяйте поведение объектов после трансформации: лишние свойства всё ещё запрещены, даже если они опциональны.

Пример

type Nullable<T> = { [P in keyof T]: T[P] | null };

interface Person {
  name: string;
  age: number;
}

const person: Nullable<Person> = { name: null, age: null };

type PersonWithAllPropertiesOptional = Partial<Person>;
const person2: PersonWithAllPropertiesOptional = { name: 'Me' };

const readonlyPerson: Readonly<Person> = { name: 'Alex' };
// readonlyPerson.name = 'Bob'; // Ошибка

Практика

• При проектировании API определяйте, какие свойства должны быть обязательными для записи и опциональными для чтения.
• Комбинируйте утилиты: Required<Readonly<T>> создаёт неизменяемый тип с обязательными полями.
• Создавайте кастомные версии (PartialBy<T, K>), если стандартных утилит недостаточно для точного поведения.