Extension de modules

L’augmentation de modules permet d’étendre ou de modifier des modules existants, afin d’ajouter des propriétés ou des méthodes personnalisées à des bibliothèques ou à des modules en TypeScript.

Cette technique est particulièrement utile lorsque vous travaillez avec des bibliothèques tierces qui nécessitent des fonctionnalités supplémentaires ou des types personnalisés.

L’augmentation de modules consiste à rouvrir un module existant et à ajouter ou modifier ses types ou ses fonctionnalités à l’aide de la syntaxe declare module.

Voici un exemple d’augmentation du module express pour ajouter une propriété personnalisée à l’objet Request :

import 'express';

declare module 'express' {
  interface Request {
    user?: { id: string; role: string };
  }
}

Après avoir augmenté le module, vous pouvez utiliser les fonctionnalités étendues dans votre application :

import express from 'express';

const app = express();

app.use((req, res, next) => {
  req.user = { id: '123', role: 'admin' };
  next();
});

app.get('/', (req, res) => {
  res.send(`User ID: ${req.user?.id}`);
});

L’augmentation de modules est souvent utilisée pour ajouter des types personnalisés à des bibliothèques tierces qui ne couvrent pas entièrement votre cas d’utilisation.

Lorsque vous augmentez un module :

• Vérifiez que vous ne remplacez pas involontairement des types existants.
• Documentez vos modifications pour faciliter la maintenance du code.
• N’utilisez l’augmentation de modules que lorsque cela est nécessaire, afin d’éviter d’encombrer les types globaux.

L’augmentation de modules est couramment utilisée pour :

• Étendre des bibliothèques tierces afin d’y intégrer des propriétés propres à l’application.
• Ajouter des propriétés d’intergiciel personnalisées dans des cadres comme Express.js.
• Adapter des modules aux exigences spécifiques d’un projet.

Étendez l’objet Request du module express afin d’y inclure une méthode personnalisée isAuthenticated. Utilisez cette méthode dans une fonction d’intergiciel d’exemple.

Vous avez appris à utiliser l’augmentation de modules pour étendre ou modifier des modules existants en TypeScript. Entraînez-vous à appliquer cette compétence pour personnaliser des bibliothèques tierces et améliorer vos applications !