Deklarasjonssammenslåing er når TypeScript kombinerer flere deklarasjoner med samme navn til en enkelt definisjon. Interfaces, navnerom og noen andre konstruksjoner slås automatisk sammen.
interface Box { width: number; }
interface Box { : ; }
Slik legger du til typer for biblioteker eller globale objekter du ikke eier:
// 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; }
}
Fordi biblioteket Request/Options er et interface, blir deklarasjonen din slått sammen med den i stedet for å konflikte — noe som lar deg trygt utvide typer du ikke kan redigere.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type kan ikke gjøre dettetype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Typaliaser er unike; bare interfaces (og navnerom) blir slått sammen — en viktig grunn til å bruke interface for utvidbare offentlige API-former.
Deklarasjonssammenslåing er mekanismen bak modulutvidelse — utvidelse av Express-forespørsler, tillegg til window, tilpasning av bibliotektyper, temakraft-systemer.
Det er essensielt kjennskap for typering av virkelige apper der du må tilpasse typer du ikke kontrollerer, uten å splitte dem.