TypeScript模块声明扩展：增强store包的StoreJsAPI
在TypeScript项目中，扩展或修改第三方库的类型声明是常见需求。本文探讨如何优雅地扩展store包的StoreJsAPI模块声明，解决直接覆盖或修改失败的问题。 目标是为set方法添加可选参数expireTime，使其签名变为set(key: string, value: any, expireTime?: number): any;。
问题：直接修改或完全覆盖store包的声明文件通常会失败，因为declare module声明的是新模块，而非修改现有模块；完全覆盖则可能因store包导出其他内容而导致冲突；直接导入原声明文件也可能因非标准导出方式而失败。
解决方案：避免直接覆盖，而是采用扩展现有声明的方式。这依赖于store包的声明文件结构。
推荐方法：声明合并
如果store包的声明文件允许扩展（许多现代库都遵循这种设计），可以使用声明合并来扩展StoreJsAPI接口。 这种方法不会替换原有声明，而是添加新的成员。
使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。
// my-declarations.d.ts
declare module 'store' {
interface StoreJsAPI {
set(key: string, value: any, expireTime?: number): any;
}
}
此文件声明了一个StoreJsAPI接口，并添加了expireTime参数。 TypeScript编译器会自动将此声明与store包的原始声明合并。 确保my-declarations.d.ts文件被正确包含在你的TypeScript编译配置中。
备选方法：包装器函数
如果声明合并不可行（例如，store包的声明文件不允许扩展），则可以创建一个包装器函数来间接扩展set方法：
// store-wrapper.ts
import store from 'store';
interface StoreJsAPIWithExpireTime {
set(key: string, value: any, expireTime?: number): any;
// ... other methods from StoreJsAPI
}
const wrappedStore: StoreJsAPIWithExpireTime = {
set(key: string, value: any, expireTime?: number): any {
if (expireTime) {
// 实现expireTime逻辑，例如使用localStorage或其他机制
localStorage.setItem(key, JSON.stringify({ value, expireTime: Date.now() + expireTime * 1000 }));
} else {
store.set(key, value);
}
},
// ... other methods from store, potentially wrapped as well
get: store.get,
remove: store.remove,
// ...etc
};
export default wrappedStore;
然后，在你的代码中使用wrappedStore代替store。 此方法完全独立于store的声明文件，并提供自定义的expireTime功能。
选择哪种方法取决于store包的具体实现和声明文件结构。 优先尝试声明合并，因为它更简洁且更易于维护。 如果声明合并不可行，则包装器函数是可靠的替代方案。 记住，始终优先考虑与现有代码的兼容性。
