Для чего используется интерфейс в TypeScript?

Интерфейсы в TypeScript

Интерфейс (interface) — это инструмент для определения контракта объекта в TypeScript. Он указывает, какие свойства и методы должен иметь объект, и служит для обеспечения типобезопасности и самодокументирования кода.

Основные использования интерфейсов

1. Определение структуры данных

Интерфейсы описывают форму объекта, гарантируя, что объект содержит необходимые свойства:

interface User {
  id: number;
  name: string;
  email: string;
  isActive?: boolean; // опциональное свойство
}

const user: User = {
  id: 1,
  name: "John",
  email: "john@example.com"
};

2. Контрактный подход в разработке

Интерфейс определяет, что должна содержать функция или класс. Это позволяет разработчикам договориться о формате данных:

interface IUserService {
  getUser(id: number): Promise<User>;
  createUser(data: Partial<User>): Promise<User>;
  deleteUser(id: number): Promise<void>;
}

class UserService implements IUserService {
  async getUser(id: number): Promise<User> {
    // реализация
  }

  async createUser(data: Partial<User>): Promise<User> {
    // реализация
  }

  async deleteUser(id: number): Promise<void> {
    // реализация
  }
}

3. Типизация функциональности

Интерфейсы используются для описания поведения функций и методов:

interface RequestHandler {
  (req: Request, res: Response, next: NextFunction): void;
}

const handler: RequestHandler = (req, res, next) => {
  res.json({ success: true });
};

4. Расширение и наследование (extends)

Интерфейсы можно комбинировать и наследовать:

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

interface Employee extends Person {
  employeeId: number;
  department: string;
}

const emp: Employee = {
  name: "Alice",
  age: 30,
  employeeId: 123,
  department: "Engineering"
};

5. Множественное наследование

Отличие интерфейсов от классов — они поддерживают множественное наследование:

interface Drawable {
  draw(): void;
}

interface Resizable {
  resize(width: number, height: number): void;
}

interface Shape extends Drawable, Resizable {
  getArea(): number;
}

Интерфейсы vs Type

• Interface: лучше для описания контрактов объектов, поддерживает наследование и слияние деклараций
• Type: более гибкий, может описывать примитивы, union-типы, кортежи

// Interface (контракт)
interface Config {
  apiUrl: string;
  timeout: number;
}

// Type (гибкость)
type Status = active | inactive | pending;
type ID = string | number;

Практические преимущества

• Раннее обнаружение ошибок: компилятор TypeScript проверяет соответствие интерфейсу при разработке
• Самодокументирование: код становится понятнее благодаря явной типизации
• Рефакторинг: при изменении структуры данных IDE автоматически указывает на ошибки
• IDE поддержка: автодополнение и подсказки типов

Интерфейсы — фундаментальный инструмент для написания надёжного, поддерживаемого и типобезопасного Node.js кода.