Структурная совместимость типов

Принципы

• TypeScript использует структурную типизацию: важна форма объекта, а не название типа.
• Псевдоним типа и интерфейс с одинаковым набором свойств совместимы и могут присваиваться друг другу.
• Такое поведение упрощает интеграцию с внешними библиотеками, но требует осторожного контроля формы объектов.

Пример

type Person = { name: string };
interface IPerson { name: string; }

let bob: Person = { name: 'Bob' };
let fred: IPerson = { name: 'Fred' };

bob = fred; // OK

Практика

• Используйте структурную совместимость при написании тестов и заглушек — достаточно совпадения свойств.
• Чтобы предотвратить случайное присваивание, добавляйте уникальные поля (брендинг) или private члены.
• При проектировании API документируйте обязательные и опциональные свойства, чтобы избежать слишком «широких» типов.