re:re:actable
Урок 051 минута чтения

Одинаковое имя интерфейсов

На этой странице
Кратко

Если объявить несколько интерфейсов с одним именем, TypeScript объединит их свойства.

Вопрос

Что будет, если два интерфейса имеют одинаковое имя?

Определение

В TypeScript интерфейсы поддерживают declaration merging. Это значит, что несколько объявлений одного интерфейса в одной области видимости объединяются в один контракт.

Пример

interface User {
  id: number;
}
 
interface User {
  name: string;
}
 
const user: User = {
  id: 1,
  name: 'Ann',
};

Итоговый User требует оба поля: id и name.

Конфликт типов

interface User {
  id: number;
}
 
interface User {
  id: string; // ошибка
}

Одинаковые свойства должны иметь совместимые типы.

Отличие от type

type User = {
  id: number;
};
 
type User = {
  name: string;
}; // ошибка: duplicate identifier

type нельзя повторно объявить с тем же именем.

Где это полезно

  • расширение типов библиотек;
  • declaration files;
  • добавление свойств к глобальным интерфейсам;
  • интеграция с существующими API.

Что важно помнить

  • Одноименные интерфейсы в одной области видимости объединяются (declaration merging).
  • Так расширяют глобальные типы (Window) и типы библиотек через module augmentation.
  • Поля с одинаковым именем должны иметь одинаковый тип, иначе ошибка.
  • Type alias с повторным именем объединять нельзя — будет ошибка «Duplicate identifier».

Мини-шпаргалка

interface A { x: number }
interface A { y: number }
// A = { x: number; y: number }

Документация

TypeScript: Declaration Merging, TypeScript: Module Augmentation.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам