Declaration Merging ist der Prozess, bei dem TypeScript mehrere Deklarationen mit demselben Namen in eine einzige Definition kombiniert. Interfaces, Namespaces und einige andere Konstrukte werden automatisch zusammengeführt.
interface { : ; }
{ : ; }
So fügen Sie Typen zu Bibliotheken oder globalen Variablen hinzu, die Sie nicht kontrollieren:
// 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; }
}
Da die Request/Options der Bibliothek ein interface ist, wird Ihre Deklaration damit zusammengeführt und verursacht keinen Konflikt — sodass Sie Typen, die Sie nicht bearbeiten können, sicher erweitern können.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type dies nicht tun kanntype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Typ-Aliase sind eindeutig; nur Interfaces (und Namespaces) werden zusammengeführt — ein wichtiger Grund, interface für erweiterbare öffentliche API-Formen zu verwenden.
Declaration Merging ist der Mechanismus hinter Module Augmentation — Erweitern von Express-Anfragen, Hinzufügen zu window, Anpassen von Bibliothekstypen, Theming-Systemen.
Es ist wesentliches Wissen zum Typisieren echter Apps, bei denen Sie Typen anpassen müssen, die Sie nicht kontrollieren, ohne sie zu forken.