Deklarationssammanslagning är TypeScripts sätt att kombinera flera deklarationer med samma namn till en enda definition. Interfaces, namespaces och vissa andra konstruktioner slås samman automatiskt.
interface { : ; }
{ : ; }
Så här lägger du till typer till bibliotek eller globala variabler som du inte äger:
// 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; }
}
Because biblioteksets Request/Options är ett interface, slås din deklaration samman i det istället för att kollidera — så du kan på ett säkert sätt utöka typer som du inte kan redigera.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type inte kan göra dettatype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Typalias är unika; endast interfaces (och namespaces) slås samman — en viktig anledning att använda interface för utökbar offentlig API-form.
Deklarationssammanslagning är mekanismen bakom modulförstärkning — utöka Express-förfrågningar, lägg till window, anpassa bibliotekstyper, temasisystem.
Det är väsentlig kunskap för typning av verkliga appar där du måste anpassa typer som du inte kontrollerar, utan att förgrena dem.