TypeScript模块声明扩展：优雅地增强store包的StoreJsAPI.set方法
在TypeScript项目中扩展第三方库的类型声明，是一项常见的需求。本文将详细讲解如何安全地扩展store包的StoreJsAPI接口，为其set方法添加expireTime参数，避免声明冲突。
开发者希望修改store包中StoreJsAPI接口的set方法签名，使其支持expireTime参数：set(key: string, value: any, expireTime?: number): any;。 直接覆盖整个模块声明容易导致冲突，因为第三方库可能包含其他导出成员。
解决方法的核心在于使用声明合并。 我们无需重写整个store模块的声明，只需扩展现有的StoreJsAPI接口即可。 这可以通过在global.d.ts (或项目中其他合适的声明文件) 中使用declare module 'store' 语句来实现。
正确的global.d.ts文件内容如下：
declare module 'store' {
interface StoreJsAPI {
set(key: string, value: any, expireTime?: number): any;
// 保持原有方法声明，如果已知
// ...other methods...
}
}
通过这种声明合并的方式，我们只扩展了set方法，添加了expireTime参数，而不会影响StoreJsAPI接口的其他方法或store模块的其他导出成员。 这有效地避免了与现有声明的冲突。 如果StoreJsAPI接口包含其他方法，务必保留这些方法的声明，确保类型定义的完整性和准确性。 这种方法保证了类型安全，并允许您在不破坏现有代码的情况下增强第三方库的功能。
