Объединение деклараций — это когда TypeScript объединяет несколько деклараций с одинаковым именем в одно определение. Интерфейсы, пространства имён и некоторые другие конструкции объединяются автоматически.
interface { : ; }
{ : ; }
Вот как вы добавляете типы к библиотекам или глобальным объектам, которыми вы не владеете:
// Add a custom property to Express's Request
declare global {
namespace Express {
interface Request { user?: { id: string }; } // merges into Express.Request
}
}
request.user; // ✅ now typed everywhere
// Augment a module
declare module "some-lib" {
interface Options { newOption: boolean; }
}
Поскольку Request/Options библиотеки — это interface, ваша декларация объединяется с ней вместо конфликта — позволяя вам безопасно расширять типы, которые вы не можете редактировать.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type не может это делатьtype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Алиасы типов уникальны; объединяются только интерфейсы (и пространства имён) — ключная причина использовать interface для расширяемых публичных форм API.
Объединение деклараций — это механизм, стоящий за расширением модулей — расширением Express-запросов, добавлением к window, кастомизацией типов библиотек, системами тематизации.
Это необходимое знание для типирования реальных приложений, где вы должны адаптировать типы, которые не контролируете, без их разделения.