La fusion de déclarations est le processus par lequel TypeScript combine plusieurs déclarations portant le même nom en une seule définition. Les interfaces, les namespaces et certaines autres constructions fusionnent automatiquement.
{ : ; }
{ : ; }
Voici comment ajouter des types aux bibliothèques ou variables globales que vous ne possédez pas :
// 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; }
}
Parce que Request/Options de la bibliothèque est une interface, votre déclaration fusionne dedans plutôt que de générer un conflit — ce qui vous permet d'étendre en toute sécurité les types que vous ne pouvez pas modifier.
function greet() {}
namespace greet { export const version = "1.0"; }
greet.version; // "1.0" — namespace merged onto the function
type ne peut pas faire celatype A = { x: number };
type A = { y: number }; // ❌ Error: duplicate identifier
Les alias de type sont uniques ; seules les interfaces (et les namespaces) fusionnent — une raison clé d'utiliser interface pour les formes d'API publiques extensibles.
La fusion de déclarations est le mécanisme derrière l'augmentation de module — étendre les requêtes Express, ajouter à window, personnaliser les types de bibliothèque, les systèmes de thème.
C'est une connaissance essentielle pour taper des applications réelles où vous devez adapter les types que vous ne contrôlez pas, sans les forker.