Declaration merging არის TypeScript-ის მეხანიზმი, რომელიც ერთმანეთის იგივე სახელის მქონე რამდენიმე declaration-ს აერთიანებს ერთ განმარტებაში. Interfaces, namespaces და ზოგიერთი სხვა კონსტრუქცია ავტომატურად იშლება.
interface Box { width: number; }
interface { : ; }
ასე დაამატებ types-ებს libraries-ებზე ან globals-ებზე, რომლებიც არ მართავ:
// 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; }
}
ვინაიდან library-ის Request/Options არის interface, თქვენი declaration შელება მის თავში, ვიდრე კონფლიქტი — ეს გაძლევთ უსაფრთხოდ გაფართოვოთ types-ები, რომლებიც არ შეგიძლიათ დაარედაქტიროთ.
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
Type aliases უნიკალური სიდიდეები არიან; მხოლოდ interfaces (და namespaces) იშლებიან — ეს არის interface-ის გამოყენების ღვინითი მიზეზი გაფართოვადი public API shapes-ებისთვის.
Declaration merging არის მექანიზმი module augmentation-ის უკან — Express requests-ის გაფართოება, window-ს დამატება, library types-ების მორგება, theming systems-ები.
ეს აუცილებელი ცოდნაა ნამდვილი აპ-ების typing-ისთვის, სადაც თქვენ უნდა მორგოთ types-ები, რომლებიც არ მართავთ, მათი fork-ის გარეშე.