@lynker-desktop/electron-sdk 0.0.9-alpha.54 → 0.0.9-alpha.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/esm/main/resource-cache.d.ts +58 -7
- package/esm/main/resource-cache.d.ts.map +1 -1
- package/esm/main/resource-cache.js +309 -117
- package/esm/main/resource-cache.js.map +1 -1
- package/main/resource-cache.d.ts +58 -7
- package/main/resource-cache.d.ts.map +1 -1
- package/main/resource-cache.js +309 -117
- package/main/resource-cache.js.map +1 -1
- package/package.json +7 -5
|
@@ -11,6 +11,39 @@ export interface ResourceCacheOptions {
|
|
|
11
11
|
/** 允许缓存的资源来源，支持null/数组/函数 */
|
|
12
12
|
allowedOrigins?: null | string[] | ((url: string) => boolean);
|
|
13
13
|
}
|
|
14
|
+
/**
|
|
15
|
+
* 下载进度回调函数类型
|
|
16
|
+
*/
|
|
17
|
+
export type DownloadProgressCallback = (progress: {
|
|
18
|
+
url: string;
|
|
19
|
+
downloaded: number;
|
|
20
|
+
total: number;
|
|
21
|
+
percentage: number;
|
|
22
|
+
speed: number;
|
|
23
|
+
}) => void;
|
|
24
|
+
/**
|
|
25
|
+
* 缓存进度回调函数类型
|
|
26
|
+
*/
|
|
27
|
+
export type CacheProgressCallback = (progress: {
|
|
28
|
+
current: number;
|
|
29
|
+
total: number;
|
|
30
|
+
url: string;
|
|
31
|
+
success: boolean;
|
|
32
|
+
result?: {
|
|
33
|
+
filePath?: string;
|
|
34
|
+
hostPath?: string;
|
|
35
|
+
mimeType?: string;
|
|
36
|
+
size?: number;
|
|
37
|
+
error?: string;
|
|
38
|
+
};
|
|
39
|
+
percentage: number;
|
|
40
|
+
downloadProgress?: {
|
|
41
|
+
downloaded: number;
|
|
42
|
+
total: number;
|
|
43
|
+
percentage: number;
|
|
44
|
+
speed: number;
|
|
45
|
+
};
|
|
46
|
+
}) => void;
|
|
14
47
|
/**
|
|
15
48
|
* 资源缓存类：拦截并缓存静态资源，提升加载性能
|
|
16
49
|
*/
|
|
@@ -25,6 +58,8 @@ export declare class ResourceCache {
|
|
|
25
58
|
private _cachedMatchFunction?;
|
|
26
59
|
/** 缓存的来源校验函数（避免重复创建） */
|
|
27
60
|
private _cachedOriginFunction?;
|
|
61
|
+
/** 正在下载的 URL 集合（避免重复下载） */
|
|
62
|
+
private _downloadingUrls;
|
|
28
63
|
/**
|
|
29
64
|
* 构造函数
|
|
30
65
|
* @param session Electron session
|
|
@@ -69,19 +104,27 @@ export declare class ResourceCache {
|
|
|
69
104
|
* 下载资源到本地缓存（异步版本，返回 Promise）
|
|
70
105
|
* @param url 资源URL
|
|
71
106
|
* @param filePath 本地缓存路径
|
|
107
|
+
* @param redirectCount 当前重定向次数（内部使用）
|
|
108
|
+
* @param onProgress 下载进度回调函数（可选）
|
|
72
109
|
* @returns Promise<void> 下载完成或失败
|
|
73
110
|
*/
|
|
74
|
-
downloadResourceAsync(url: string, filePath: string): Promise<void>;
|
|
111
|
+
downloadResourceAsync(url: string, filePath: string, redirectCount?: number, onProgress?: DownloadProgressCallback): Promise<void>;
|
|
75
112
|
/**
|
|
76
113
|
* 下载资源到本地缓存（同步版本，不返回 Promise，用于拦截器）
|
|
77
114
|
* @param url 资源URL
|
|
78
115
|
* @param filePath 本地缓存路径
|
|
79
116
|
*/
|
|
80
117
|
downloadResource(url: string, filePath: string): void;
|
|
118
|
+
/**
|
|
119
|
+
* 从文件扩展名获取 MIME 类型
|
|
120
|
+
* @param ext 文件扩展名（带或不带点）
|
|
121
|
+
* @returns MIME 类型
|
|
122
|
+
*/
|
|
123
|
+
private _getMimeTypeFromExt;
|
|
81
124
|
/**
|
|
82
125
|
* 检测并处理 base64 data URL
|
|
83
126
|
* @param url 资源URL
|
|
84
|
-
* @returns 如果是 base64 URL，返回 true
|
|
127
|
+
* @returns 如果是 base64 URL，返回 true、文件扩展名、MIME 类型和数据；否则返回 false
|
|
85
128
|
*/
|
|
86
129
|
private _isBase64DataUrl;
|
|
87
130
|
/**
|
|
@@ -94,24 +137,32 @@ export declare class ResourceCache {
|
|
|
94
137
|
* 手动缓存指定 URL 的资源
|
|
95
138
|
* @param url 要缓存的资源 URL（支持普通 URL 和 base64 data URL）
|
|
96
139
|
* @param force 是否强制重新下载，即使缓存有效（默认 false）
|
|
97
|
-
* @
|
|
140
|
+
* @param ignoreOrigin 是否忽略来源检查（默认 false）
|
|
141
|
+
* @param onDownloadProgress 下载进度回调函数（可选）
|
|
142
|
+
* @returns Promise<{ filePath: string, hostPath: string, mimeType: string, size: number }> 返回缓存文件路径、主机路径、MIME 类型和文件大小
|
|
98
143
|
* @throws 如果 URL 不匹配缓存规则或来源不允许，会抛出错误
|
|
99
144
|
*/
|
|
100
|
-
cacheUrl(url: string, force?: boolean, ignoreOrigin?: boolean): Promise<{
|
|
145
|
+
cacheUrl(url: string, force?: boolean, ignoreOrigin?: boolean, onDownloadProgress?: DownloadProgressCallback): Promise<{
|
|
101
146
|
filePath: string;
|
|
102
147
|
hostPath: string;
|
|
148
|
+
mimeType: string;
|
|
149
|
+
size: number;
|
|
103
150
|
}>;
|
|
104
151
|
/**
|
|
105
152
|
* 批量缓存多个 URL 的资源
|
|
106
153
|
* @param urls 要缓存的资源 URL 数组
|
|
107
154
|
* @param force 是否强制重新下载，即使缓存有效（默认 false）
|
|
108
|
-
* @
|
|
155
|
+
* @param ignoreOrigin 是否忽略来源检查（默认 false）
|
|
156
|
+
* @param onProgress 进度回调函数（可选）
|
|
157
|
+
* @returns Promise<Array<{ url: string, success: boolean, filePath?: string, hostPath?: string, mimeType?: string, size?: number, error?: string }>> 返回每个 URL 的缓存结果
|
|
109
158
|
*/
|
|
110
|
-
addCacheUrls(urls: string[], force?: boolean, ignoreOrigin?: boolean): Promise<Array<{
|
|
159
|
+
addCacheUrls(urls: string[], force?: boolean, ignoreOrigin?: boolean, onProgress?: CacheProgressCallback): Promise<Array<{
|
|
111
160
|
url: string;
|
|
112
161
|
success: boolean;
|
|
113
162
|
filePath?: string;
|
|
114
163
|
hostPath?: string;
|
|
164
|
+
mimeType?: string;
|
|
165
|
+
size?: number;
|
|
115
166
|
error?: string;
|
|
116
167
|
}>>;
|
|
117
168
|
/**
|
|
@@ -148,7 +199,7 @@ export declare class ResourceCache {
|
|
|
148
199
|
*/
|
|
149
200
|
private _cleanOldCache;
|
|
150
201
|
/**
|
|
151
|
-
*
|
|
202
|
+
* 清理所有缓存文件（完全异步版本，性能更好）
|
|
152
203
|
* @returns Promise<{ success: number, failed: number, totalSize: number }> 返回清理统计信息
|
|
153
204
|
*/
|
|
154
205
|
clearCache(): Promise<{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resource-cache.d.ts","sourceRoot":"","sources":["../../src/main/resource-cache.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"resource-cache.d.ts","sourceRoot":"","sources":["../../src/main/resource-cache.ts"],"names":[],"mappings":"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"}
|