在TypeScript中扩展Map的map方法后，原有方法失效如何解决？

问题根源 #

你遇到的问题主要来自两个方面：

1. Map.forEach参数顺序错误：原生Map.prototype.forEach的回调参数顺序是(value: V, key: K, map: Map<K, V>)，你写反成了(key: K, value: V)，这不仅会导致map方法逻辑出错，还会干扰TypeScript对Map类型的正常推断。
2. 全局类型扩展的加载问题：如果TypeScript没有正确识别你的全局扩展文件，会错误覆盖原有Map类型定义，导致.set()等原生方法被标记为undefined。

修正后的代码 #

先修正map方法的逻辑，确保参数顺序符合原生规范：

export {}

declare global {
  interface Map<K, V> {
    map<T>(predicate: (key: K, value: V) => T): Map<K, T>;
  }
}

Map.prototype.map = function<K, V, T>(predicate: (key: K, value: V) => T): Map<K, T> {
  const newMap = new Map<K, T>();
  
  // 修正forEach参数顺序：value在前，key在后
  this.forEach((value: V, key: K) => {
    newMap.set(key, predicate(key, value));
  });

  return newMap;
};

tsconfig.json配置检查 #

确保你的tsconfig.json包含以下关键配置，让TypeScript正确加载全局类型扩展：

{
  "compilerOptions": {
    "target": "ES6", // 至少指定ES6，保证Map特性被支持
    "lib": ["ES6", "DOM"], // 引入ES6库定义，确保原生Map类型正常识别
    "module": "ESNext",
    "moduleResolution": "Node",
    "strict": true,
    "esModuleInterop": true
  },
  "include": [
    "src/**/*", // 确保扩展文件在src目录下被扫描
    "path/to/your/map-extension.ts" // 若扩展文件不在src，手动添加其路径
  ]
}

额外注意事项 #

• 扩展文件必须通过export {}标记为模块，否则TypeScript不会将其视为全局类型扩展，而是会直接覆盖原有Map接口。
• 检查项目中是否有其他重复定义Map接口的文件，避免类型合并冲突。

内容的提问来源于stack exchange，提问作者serlingpa