В чем разница между interface и type в TypeScript и когда что использовать?

Основные различия между interface и type в TypeScript

Отличный вопрос! Действительно, на первый взгляд interface и type выглядят взаимозаменяемыми, но у них есть важные отличия. Давайте разберем их подробно.

1. Расширение (extends vs intersection)

interface использует ключевое слово extends для наследования:

interface Animal {
  name: string;
}

interface Dog extends Animal {
  breed: string;
}

// Dog: { name: string; breed: string; }

type использует оператор пересечения &:

type Animal = {
  name: string;
}

type Dog = Animal & {
  breed: string;
}

// Dog: { name: string; breed: string; }

2. Слияние объявлений (declaration merging)

Это ключевое отличие. interface можно объявлять несколько раз с одним именем — они автоматически объединятся:

interface User {
  name: string;
}

interface User {
  age: number;
}

// Результат: User = { name: string; age: number; }

type так делать нельзя — будет ошибка "Duplicate identifier".

3. Возможности type, которых нет у interface

type может представлять не только объекты, но и:

• Примитивные типы: type ID = string | number;
• Литеральные типы: type Status = 'active' | 'inactive';
• Кортежи: type Pair = [string, number];
• Условные типы: type IsString<T> = T extends string ? true : false;
• Mapped types: type Readonly<T> = { readonly [K in keyof T]: T[K] };

4. Что умеет interface, но не умеет type?

Кроме слияния объявлений, interface может:

• Наследоваться от класса: interface MyInterface extends MyClass { ... }
• Использоваться в implements для классов: class MyClass implements MyInterface { ... }

5. Производительность и компиляция

С точки зрения производительности компиляции, interface обычно быстрее, потому что TypeScript может кэшировать результаты. type с пересечениями (&) может быть медленнее на больших проектах из-за рекурсивной проверки типов.

6. Когда что использовать?

Используйте interface, когда:

• Вы определяете форму объекта (особенно для API/DTO)
• Вам нужно слияние объявлений (например, для расширения сторонних типов)
• Вы пишете библиотеку — interface лучше документируется
• Вы работаете с классами (implements)

Используйте type, когда:

• Вам нужны union/intersection типы
• Вы работаете с примитивами, кортежами или литералами
• Вам нужны условные или mapped типы
• Вы создаете вспомогательные типы-утилиты

Пример из практики

// Хорошо для interface
interface ApiResponse<T> {
  data: T;
  status: number;
  message: string;
}

// Хорошо для type
type UserRole = 'admin' | 'user' | 'guest';
type ApiResult<T> = ApiResponse<T> | { error: string };

Итог

В 80% случаев для объектов можно использовать и то, и другое. Но если вы сомневаетесь — начинайте с interface, а переходите на type только когда нужны его специфические возможности. Это общепринятая практика в TypeScript-сообществе.

type A = { a: string };
type B = { b: number };
type C = A & B & { c: boolean }; // Работает, но может быть медленно при вложенности

// Базовый интерфейс
interface BaseEntity {
  id: number;
  createdAt: Date;
}

// Тип для расширения
type UserEntity = BaseEntity & {
  name: string;
  email: string;
};