Introducción a la ampliación de módulos

La ampliación de módulos permite extender o modificar módulos existentes, lo que hace posible añadir propiedades o métodos personalizados a bibliotecas o módulos en TypeScript.

Resulta especialmente útil cuando trabaja con bibliotecas de terceros que necesitan funcionalidad adicional o tipos personalizados.

¿Qué es la ampliación de módulos?

La ampliación de módulos consiste en volver a abrir un módulo existente y añadir o modificar sus tipos o su funcionalidad mediante la sintaxis declare module.

Ejemplo básico de ampliación de módulos

Este es un ejemplo de ampliación del módulo express para añadir una propiedad personalizada al objeto Request:

import 'express';

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

Usar módulos ampliados

Después de ampliar el módulo, puede usar la funcionalidad extendida en su aplicación:

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}`);
});

Añadir tipos personalizados a módulos de terceros

La ampliación de módulos se usa a menudo para añadir tipos personalizados a bibliotecas de terceros que no cubren por completo su caso de uso.

Precauciones con la ampliación de módulos

Al ampliar un módulo:

• Asegúrese de no sobrescribir tipos existentes de forma involuntaria.
• Documente los cambios para facilitar el mantenimiento del código.
• Use la ampliación de módulos solo cuando sea necesario para evitar sobrecargar los tipos globales.

Casos de uso reales

La ampliación de módulos se usa habitualmente para:

• Extender bibliotecas de terceros para incluir propiedades específicas de la aplicación.
• Añadir propiedades de middleware personalizadas en frameworks como Express.js.
• Adaptar módulos a los requisitos específicos del proyecto.

Tarea práctica

Extienda el objeto Request del módulo express para incluir un método personalizado isAuthenticated. Use este método en una función de middleware de ejemplo.

¡Enhorabuena!

Ha aprendido a usar la ampliación de módulos para extender o modificar módulos existentes en TypeScript. ¡Practique esta habilidad para personalizar bibliotecas de terceros y mejorar sus aplicaciones!