Penggabungan deklarasi adalah TypeScript menggabungkan beberapa deklarasi dengan nama yang sama menjadi satu definisi. Interface, namespace, dan beberapa konstruksi lainnya bergabung secara otomatis.
interface { : ; }
{ : ; }
Ini adalah cara Anda menambahkan tipe ke perpustakaan atau global yang tidak Anda miliki:
// 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; }
}
Karena Request/Options perpustakaan adalah interface, deklarasi Anda bergabung ke dalamnya daripada bertentangan — membiarkan Anda memperluas tipe dengan aman yang tidak dapat Anda edit.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type tidak bisa melakukan initype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Alias tipe bersifat unik; hanya interface (dan namespace) yang bergabung — alasan utama menggunakan interface untuk bentuk API publik yang dapat diperluas.
Penggabungan deklarasi adalah mekanisme di balik penambahan modul — memperluas permintaan Express, menambah window, menyesuaikan tipe perpustakaan, sistem tema.
Ini adalah pengetahuan penting untuk mengetik aplikasi nyata di mana Anda harus beradaptasi dengan tipe yang tidak Anda kontrol, tanpa memisahkannya.