Deklaracijos sujungimas yra TypeScript funkcija, kuri sujungia kelias deklaracijas su tuo pačiu pavadinimu į vieną apibrėžimą. Sąsajos, vardų sritys ir kai kurie kiti konstruktai sujungiami automatiškai.
interface { : ; }
{ : ; }
Šitaip pridėti tipus bibliotekoms arba globaliam objektui, kurie jums nepriklauso:
// 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; }
}
Nes bibliotekos Request/Options yra interface, jūsų deklaracija sujungiama su juo, užuot sukėlus konfliktą — leidžiant jums saugiai pratęsti tipus, kurių negalite redaguoti.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type negali to darytitype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Tipo alias'ai yra unikalūs; sujungti gali tik sąsajos (ir vardų sritys) — tai yra pagrindinė priežastis naudoti interface išplečiamiems viešiems API formams.
Deklaracijos sujungimas yra mechanizmas, dėl kurio veikia modulio papildymas — Express užklausų papildymas, dalykų pridėjimas prie window, bibliotekų tipų pritaikymas, temų sistemos.
Tai yra esminės žinios tipizuojant realias aplikacijas, kuriose turite pritaikyti tipus, kurie jums nepriklauso, neišsukant jų kopijos.