TypeScript 模块扩充会覆盖原始模块？

Question

在我的 Node.js / Express 应用程序中，我已经拥有 Headers.ts 文件很长一段时间了，其中包含以下内容：

type HttpHeader = 'X-My-Header' | 'X-My-Other-Header' | 'X-Another';

declare module 'express-serve-static-core' {
    import * as http from 'http';
    interface Request extends http.IncomingMessage, Express.Request {
        header(name: HttpHeader): string | undefined;
    }
}

它曾经编译得很好，但是，在最近的rm -rf node_modules 和npm install 再次之后，我遇到了很多类似的错误

error TS2339: Property 'get' does not exist on type 'Request'.
error TS2339: Property 'end' does not exist on type 'Response'.

似乎核心问题是node_modules/@types/express/index.d.ts 将import * as core from "express-serve-static-core" 解析为我的小增强并完全跳过加载真实的东西。我不知道为什么，因为我确实正确安装了一个文件夹 node_modules/@types/express-serve-static-core。

会是什么？

Answer 1

从以下方面来看：

import * as http from 'http';

在你的模块声明中，你实际上并不是在写一个你想要的模块“agumentation”，而是替换现有的模块。

为了编写模块扩充，您需要这样编写：

import { Request} from 'express-serve-static-core';
import * as http from 'http';

export type HttpHeader = 'X-My-Header' | 'X-My-Other-Header' | 'X-Another';

declare module 'express-serve-static-core'{
    export interface Request extends http.IncomingMessage, Express.Request {
        header(name: HttpHeader): string | undefined;
    }
}

首先要注意的是，它应该是一个外部“文件”模块（它应该有导入和导出）。

要注意的第二件事是import * as http 应该放在模块扩充之外，在里面是不合法的。

声明的模块现在严格用作扩充。它不会覆盖或替换现有的express-server-static-core 模块。事实上，该模块需要存在才能对其进行扩充（例如，如果您拼错了模块名称，它将无法编译）。

我无法从您的示例中看出为什么您的代码以前有效。之前express-server-static-core 声明文件的实现方式可能有所不同。但是，如果您遵循此示例，则应该对您有用。