Что такое интерфейс в TS?

Что такое интерфейс в TypeScript?

В TypeScript интерфейс (interface) является мощным инструментом для описания структуры объектов и определения контрактов, которым должны соответствовать классы, функции или другие сущности. Это ключевая часть системы типов TS, позволяющая явно задавать ожидаемые формы данных, обеспечивая надежную проверку типов во время разработки и предотвращая множество ошибок в рантайме.

Основное назначение интерфейсов

Интерфейсы в TS служат для:

• Описания формы объектов: указания, какие свойства должны присутствовать в объекте, их типов и опциональности.
• Определения контрактов для классов: через реализацию (implements) интерфейса класс обязан предоставить методы и свойства, объявленные в интерфейсе.
• Обеспечения совместимости типов: проверки, что объект или класс соответствует ожидаемой структуре (принцип "structural subtyping" или "duck typing").

Синтаксис и базовое использование

Базовый интерфейс описывает объект. Создается с помощью ключевого слова interface.

interface User {
    id: number;
    name: string;
    email: string;
    age?: number; // Опциональное свойство (может отсутствовать)
}

Этот интерфейс User требует, что любой объект, соответствующий ему, должен иметь свойства id, name, email типа number и string, а свойство age (с типом number) может быть отсутствующим.

const validUser: User = {
    id: 1,
    name: 'Иван',
    email: 'ivan@example.com',
    age: 30 // Можно добавить
};

const anotherValidUser: User = {
    id: 2,
    name: 'Петр',
    email: 'petr@example.com' // age отсутствует, это допустимо
};

// Ошибка типа: свойство 'email' отсутствует
const invalidUser: User = {
    id: 3,
    name: 'Семен'
};

Расширение интерфейсов (наследование)

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

interface Employee extends User {
    position: string;
    salary: number;
    departmentId: number;
}

const employee: Employee = {
    id: 101,
    name: 'Алексей',
    email: 'alexey@company.com',
    position: 'Senior Developer',
    salary: 150000,
    departmentId: 5
};

Интерфейсы для функций и методов

Интерфейсы могут описывать не только объекты, но и сигнатуры функций (формат их вызова).

interface SearchFunction {
    (source: string, subString: string): boolean;
}

const mySearch: SearchFunction = function(source: string, subString: string): boolean {
    return source.includes(subString);
};

Интерфейсы для классов (реализация)

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

interface ClockInterface {
    currentTime: Date;
    setTime(d: Date): void;
}

class DigitalClock implements ClockInterface {
    currentTime: Date = new Date();

    setTime(d: Date): void {
        this.currentTime = d;
    }

    // Класс может иметь и собственные методы
    getTimeInString(): string {
        return this.currentTime.toISOString();
    }
}

Если класс не реализует все обязательные члены интерфейса, компилятор TypeScript выдаст ошибку.

Интерфейсы vs. Типы (type)

Часто возникает вопрос о различиях между interface и type. Основные различия:

• Расширение: Интерфейсы расширяются через extends, типы — через пересечение (&).
• Декларативное объединение: Интерфейсы можно объявлять многократно (они автоматически сливаются), что полезно для дополнения существующих интерфейсов (например, в библиотеках). Типы не поддерживают эту возможность.
• Применение: Интерфейсы традиционно больше используются для описания форм объектов и контрактов классов, а типы (type) более универсальны и могут создавать объединения (union), пересечения (intersection), а также описывать примитивы.

// Интерфейсы можно объединять через повторное объявление
interface Box {
    height: number;
}
interface Box {
    width: number;
}
// Результат: Box имеет свойства height и width

// Типы создают сложные конструкции
type ID = number | string;
type Coord = { x: number; y: number };

Практическая ценность интерфейсов

1. Документирование кода: Интерфейс служит явной документацией, описывая, что ожидается от объекта или класса.
2. Раннее обнаружение ошибок: Компилятор TS проверяет соответствие типов на этапе разработки, а не во время выполнения программы.
3. Улучшение поддержки IDE: Интеллектуальные редакторы (VS Code, WebStorm) используют интерфейсы для предоставления автодополнения, подсказок и информации о типах.
4. Структурная проверка типов (Duck Typing):

   function printUser(user: User) {
       console.log(`ID: ${user.id}, Name: ${user.name}`);
   }
   // Функция принимает любой объект, имеющий свойства id и name типа number/string,
   // даже если он явно не аннотирован как User.
   const someObject = { id: 5, name: 'Мария', email: 'test@mail.ru' };
   printUser(someObject); // OK, структура совпадает
   

В заключение, интерфейсы в TypeScript — это фундаментальный механизм для создания строгих, самодокументированных и легко поддерживаемых систем типов. Они позволяют описывать сложные структуры данных, обеспечивать соблюдение контрактов в классах и функциях, а также значительно повышают надежность и читаемость кода в больших проектах.