Deklaraatioiden yhdistäminen on TypeScriptin prosessi, jossa useita deklaraatioita, joilla on sama nimi, yhdistetään yhdeksi määritelmäksi. Interfaces, namespaces ja jotkin muut rakenteet yhdistyvät automaattisesti.
interface { : ; }
{ : ; }
Näin lisäät tyyppejä kirjastoihin tai globaaleihin muuttujiin, joita et omista:
// 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; }
}
Koska kirjaston Request/Options on interface, sinun deklaraatiosi yhdistyy siihen sen sijaan, että aiheuttaisi konfliktia — jolloin voit turvallisesti laajentaa tyyppejä, joita et voi muokata.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type ei voi tehdä tätätype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Tyyppialiakset ovat ainutlaatuisia; vain interfaces (ja namespaces) yhdistyvät — keskeinen syy käyttää interface laajennettavissa oleviin julkisiin API-muotoihin.
Deklaraatioiden yhdistäminen on mekanismi moduulin laajentamisen takana — Express-pyyntöjen laajentaminen, lisääminen window-ikkunaan, kirjastotyyppien mukauttaminen, teemajärjestelmät.
Se on olennaista tietoa todellisten sovellusten kirjoittamiseen, joissa sinun on mukauttaa tyyppejä, joita et hallitse, niitä haarauttamatta.