模块增强简介

模块增强允许您扩展或修改现有模块，从而可以在 TypeScript 中向库或模块添加自定义属性或方法。

当您使用需要额外功能或自定义类型的第三方库时，这项功能尤其有用。

什么是模块增强

模块增强是指重新打开现有模块，并使用 declare module 语法添加或修改其中的类型或功能。

模块增强基本示例

下面是增强 express 模块、向 Request 对象添加自定义属性的示例：

import 'express';

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

使用增强后的模块

增强模块后，您可以在应用中使用扩展后的功能：

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

向第三方模块添加自定义类型

模块增强通常用于向未完全覆盖您的使用场景的第三方库添加自定义类型。

模块增强的注意事项

增强模块时：

• 请确保不会意外覆盖现有类型。
• 请记录您的更改，以便更好地维护代码。
• 仅在必要时使用模块增强，以免使全局类型变得杂乱。

实际应用场景

模块增强通常用于：

• 扩展第三方库，使其包含特定于应用的属性。
• 在 Express.js 等框架中添加自定义中间件属性。
• 根据特定项目需求调整模块。

练习任务

扩展 express 模块中的 Request 对象，为其添加自定义的 isAuthenticated 方法。在示例中间件函数中使用此方法。

恭喜您！

您已经学会了如何在 TypeScript 中使用模块增强来扩展或修改现有模块。请练习这项技能，自定义第三方库并增强您的应用！