Declaration merging ialah TypeScript menggabungkan beberapa pengisytiharan dengan nama yang sama menjadi satu takrifan tunggal. Interface, namespace, dan beberapa binaan lain bergabung secara automatik.
interface { : ; }
{ : ; }
Inilah cara anda menambah jenis kepada pustaka atau global yang anda tidak 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; }
}
Kerana Request/Options pustaka tersebut ialah sebuah interface, pengisytiharan anda bergabung ke dalamnya dan bukannya berkonflik — membolehkan anda memperluas jenis yang tidak boleh anda sunting dengan selamat.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type tidak boleh melakukan initype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Alias jenis adalah unik; hanya interface (dan namespace) yang bergabung — satu sebab utama untuk menggunakan interface bagi bentuk API awam yang boleh diperluas.
Declaration merging ialah mekanisme di sebalik module augmentation — memperluas request Express, menambah kepada window, menyesuaikan jenis pustaka, sistem tema.
Ia ialah pengetahuan penting untuk menentukan jenis aplikasi sebenar di mana anda mesti menyesuaikan jenis yang tidak anda kawal, tanpa membuat fork ke atasnya.