Rozszerzanie modułów

Rozszerzanie modułów umożliwia rozszerzanie lub modyfikowanie istniejących modułów, dzięki czemu można dodawać własne właściwości lub metody do bibliotek i modułów w TypeScript.

Jest to szczególnie przydatne podczas pracy z bibliotekami zewnętrznymi, które wymagają dodatkowych funkcji lub niestandardowych typów.

Rozszerzanie modułów polega na ponownym otwarciu istniejącego modułu i dodaniu do niego typów lub funkcji albo ich modyfikowaniu za pomocą składni declare module.

Oto przykład rozszerzenia modułu express w celu dodania własnej właściwości do obiektu Request:

import 'express';

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

Po rozszerzeniu modułu można używać rozszerzonej funkcjonalności w aplikacji:

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

Rozszerzanie modułów jest często używane do dodawania niestandardowych typów do bibliotek zewnętrznych, które nie obsługują w pełni danego przypadku użycia.

Podczas rozszerzania modułu:

• Proszę upewnić się, że istniejące typy nie zostaną przypadkowo nadpisane.
• Proszę udokumentować wprowadzone zmiany, aby ułatwić utrzymanie kodu.
• Proszę używać rozszerzania modułów tylko wtedy, gdy jest to konieczne, aby uniknąć zaśmiecania typów globalnych.

Rozszerzanie modułów jest często używane do:

• Rozszerzania bibliotek zewnętrznych o właściwości specyficzne dla aplikacji.
• Dodawania niestandardowych właściwości middleware w frameworkach takich jak Express.js.
• Dostosowywania modułów do wymagań konkretnego projektu.

Proszę rozszerzyć obiekt Request z modułu express, dodając niestandardową metodę isAuthenticated. Proszę użyć tej metody w przykładowej funkcji middleware.

Nauczyli się Państwo używać rozszerzania modułów do rozszerzania lub modyfikowania istniejących modułów w TypeScript. Proszę ćwiczyć tę umiejętność, aby dostosowywać biblioteki zewnętrzne i rozwijać swoje aplikacje!