@cloudcome/utils-core 1.19.1 → 1.20.1
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/README.md +72 -73
- package/dist/array.cjs +181 -125
- package/dist/array.cjs.map +1 -1
- package/dist/array.mjs +181 -133
- package/dist/array.mjs.map +1 -1
- package/dist/async.cjs +181 -171
- package/dist/async.cjs.map +1 -1
- package/dist/async.mjs +181 -174
- package/dist/async.mjs.map +1 -1
- package/dist/base64.cjs +16 -12
- package/dist/base64.cjs.map +1 -1
- package/dist/base64.mjs +17 -14
- package/dist/base64.mjs.map +1 -1
- package/dist/cache.cjs +79 -67
- package/dist/cache.cjs.map +1 -1
- package/dist/cache.d.ts +3 -3
- package/dist/cache.mjs +80 -71
- package/dist/cache.mjs.map +1 -1
- package/dist/color.cjs +478 -167
- package/dist/color.cjs.map +1 -1
- package/dist/color.d.ts +3 -3
- package/dist/color.mjs +480 -197
- package/dist/color.mjs.map +1 -1
- package/dist/crypto.cjs +474 -687
- package/dist/crypto.cjs.map +1 -1
- package/dist/crypto.mjs +476 -693
- package/dist/crypto.mjs.map +1 -1
- package/dist/date.cjs +972 -161
- package/dist/date.cjs.map +1 -1
- package/dist/date.d.ts +2 -2
- package/dist/date.mjs +962 -191
- package/dist/date.mjs.map +1 -1
- package/dist/dict.cjs +90 -52
- package/dist/dict.cjs.map +1 -1
- package/dist/dict.d.ts +1 -1
- package/dist/dict.mjs +91 -54
- package/dist/dict.mjs.map +1 -1
- package/dist/easing.cjs +104 -103
- package/dist/easing.cjs.map +1 -1
- package/dist/easing.mjs +105 -133
- package/dist/easing.mjs.map +1 -1
- package/dist/emitter.cjs +101 -96
- package/dist/emitter.cjs.map +1 -1
- package/dist/emitter.mjs +101 -97
- package/dist/emitter.mjs.map +1 -1
- package/dist/env.cjs +43 -9
- package/dist/env.cjs.map +1 -1
- package/dist/env.d.ts +1 -1
- package/dist/env.mjs +43 -15
- package/dist/env.mjs.map +1 -1
- package/dist/error.cjs +26 -5
- package/dist/error.cjs.map +1 -1
- package/dist/error.mjs +26 -7
- package/dist/error.mjs.map +1 -1
- package/dist/exception.cjs +38 -20
- package/dist/exception.cjs.map +1 -1
- package/dist/exception.d.ts +5 -5
- package/dist/exception.mjs +38 -21
- package/dist/exception.mjs.map +1 -1
- package/dist/function.cjs +128 -68
- package/dist/function.cjs.map +1 -1
- package/dist/function.mjs +128 -72
- package/dist/function.mjs.map +1 -1
- package/dist/index.cjs +8 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.mjs +9 -5
- package/dist/index.mjs.map +1 -1
- package/dist/number.cjs +10 -14
- package/dist/number.mjs +2 -15
- package/dist/object/get-set.d.ts +2 -2
- package/dist/object/merge.d.ts +2 -2
- package/dist/object.cjs +369 -106
- package/dist/object.cjs.map +1 -1
- package/dist/object.mjs +366 -115
- package/dist/object.mjs.map +1 -1
- package/dist/path.cjs +144 -55
- package/dist/path.cjs.map +1 -1
- package/dist/path.mjs +144 -62
- package/dist/path.mjs.map +1 -1
- package/dist/promise.cjs +84 -43
- package/dist/promise.cjs.map +1 -1
- package/dist/promise.mjs +85 -50
- package/dist/promise.mjs.map +1 -1
- package/dist/qs.cjs +63 -39
- package/dist/qs.cjs.map +1 -1
- package/dist/qs.mjs +64 -42
- package/dist/qs.mjs.map +1 -1
- package/dist/regexp.cjs +118 -35
- package/dist/regexp.cjs.map +1 -1
- package/dist/regexp.mjs +119 -46
- package/dist/regexp.mjs.map +1 -1
- package/dist/string.cjs +12 -15
- package/dist/string.mjs +2 -16
- package/dist/string2.cjs +378 -142
- package/dist/string2.cjs.map +1 -1
- package/dist/string2.mjs +259 -143
- package/dist/string2.mjs.map +1 -1
- package/dist/time.cjs +136 -59
- package/dist/time.cjs.map +1 -1
- package/dist/time.mjs +136 -65
- package/dist/time.mjs.map +1 -1
- package/dist/timer.cjs +122 -112
- package/dist/timer.cjs.map +1 -1
- package/dist/timer.mjs +123 -115
- package/dist/timer.mjs.map +1 -1
- package/dist/tree.cjs +207 -112
- package/dist/tree.cjs.map +1 -1
- package/dist/tree.mjs +207 -116
- package/dist/tree.mjs.map +1 -1
- package/dist/try/curry.d.ts +1 -1
- package/dist/try.cjs +36 -37
- package/dist/try.cjs.map +1 -1
- package/dist/try.mjs +35 -37
- package/dist/try.mjs.map +1 -1
- package/dist/type.cjs +126 -24
- package/dist/type.cjs.map +1 -1
- package/dist/type.d.ts +2 -2
- package/dist/type.mjs +128 -45
- package/dist/type.mjs.map +1 -1
- package/dist/types.cjs +0 -2
- package/dist/types.d.ts +1 -1
- package/dist/types.mjs +0 -2
- package/dist/unique.cjs +41 -38
- package/dist/unique.cjs.map +1 -1
- package/dist/unique.mjs +42 -41
- package/dist/unique.mjs.map +1 -1
- package/dist/url.cjs +39 -30
- package/dist/url.cjs.map +1 -1
- package/dist/url.mjs +40 -33
- package/dist/url.mjs.map +1 -1
- package/dist/version.cjs +51 -33
- package/dist/version.cjs.map +1 -1
- package/dist/version.mjs +51 -35
- package/dist/version.mjs.map +1 -1
- package/package.json +109 -110
- package/dist/const.cjs +0 -14
- package/dist/const.cjs.map +0 -1
- package/dist/const.mjs +0 -15
- package/dist/const.mjs.map +0 -1
- package/dist/core.cjs +0 -362
- package/dist/core.cjs.map +0 -1
- package/dist/core.mjs +0 -363
- package/dist/core.mjs.map +0 -1
- package/dist/crypto/md5.d.mts +0 -1
- package/dist/crypto/sha1.d.mts +0 -1
- package/dist/crypto/sha256.d.mts +0 -1
- package/dist/crypto/sha512.d.mts +0 -1
- package/dist/each.cjs +0 -18
- package/dist/each.cjs.map +0 -1
- package/dist/each.mjs +0 -19
- package/dist/each.mjs.map +0 -1
- package/dist/merge.cjs +0 -87
- package/dist/merge.cjs.map +0 -1
- package/dist/merge.mjs +0 -88
- package/dist/merge.mjs.map +0 -1
- package/dist/number.cjs.map +0 -1
- package/dist/number.mjs.map +0 -1
- package/dist/string.cjs.map +0 -1
- package/dist/string.mjs.map +0 -1
- package/dist/types.cjs.map +0 -1
- package/dist/types.mjs.map +0 -1
package/dist/async.mjs
CHANGED
|
@@ -1,179 +1,186 @@
|
|
|
1
1
|
import { fnNoop } from "./function.mjs";
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
}
|
|
131
|
-
}
|
|
2
|
+
//#region src/async.ts
|
|
3
|
+
/**
|
|
4
|
+
* 异步任务队列,用于管理和控制异步任务的执行
|
|
5
|
+
* @template T - 任务返回值的类型
|
|
6
|
+
*/
|
|
7
|
+
var AsyncQueue = class {
|
|
8
|
+
#tasks = [];
|
|
9
|
+
#length = 0;
|
|
10
|
+
/**
|
|
11
|
+
* 创建一个异步任务队列
|
|
12
|
+
* @param asyncFns - 要执行的异步函数数组
|
|
13
|
+
* @param options - 队列配置选项
|
|
14
|
+
*/
|
|
15
|
+
constructor(asyncFns, options) {
|
|
16
|
+
this.options = options;
|
|
17
|
+
asyncFns.forEach((afn, _idx) => {
|
|
18
|
+
this.#add("push", afn);
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
get length() {
|
|
22
|
+
return this.#length;
|
|
23
|
+
}
|
|
24
|
+
get limit() {
|
|
25
|
+
return this.options?.limit || 0;
|
|
26
|
+
}
|
|
27
|
+
#add(method, afn, pwr) {
|
|
28
|
+
this.#tasks[method]({
|
|
29
|
+
idx: this.#length++,
|
|
30
|
+
afn,
|
|
31
|
+
pwr
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
#addAndRun(method, afn) {
|
|
35
|
+
if (this.#stopLength >= 0) throw new Error("异步队列已被终止,无法添加新的任务");
|
|
36
|
+
const pwr = Promise.withResolvers();
|
|
37
|
+
this.#add(method, afn, pwr);
|
|
38
|
+
if (this.#startPwr && this.#running === 0) this.#run();
|
|
39
|
+
return pwr.promise;
|
|
40
|
+
}
|
|
41
|
+
async push(afn) {
|
|
42
|
+
return this.#addAndRun("push", afn);
|
|
43
|
+
}
|
|
44
|
+
async unshift(afn) {
|
|
45
|
+
return this.#addAndRun("unshift", afn);
|
|
46
|
+
}
|
|
47
|
+
#startResolved = 0;
|
|
48
|
+
#startRejected = 0;
|
|
49
|
+
get startSettled() {
|
|
50
|
+
return this.#startResolved === this.#startLength || this.#startRejected > 0;
|
|
51
|
+
}
|
|
52
|
+
#startResults = [];
|
|
53
|
+
#startPwr = null;
|
|
54
|
+
#startLength = 0;
|
|
55
|
+
/**
|
|
56
|
+
* 启动队列中的任务执行
|
|
57
|
+
* @returns 返回一个 Promise,在所有启动任务完成后解析为结果数组
|
|
58
|
+
*/
|
|
59
|
+
async start() {
|
|
60
|
+
if (this.#startPwr) return this.#startPwr.promise;
|
|
61
|
+
this.#startLength = this.#length;
|
|
62
|
+
this.#startPwr = Promise.withResolvers();
|
|
63
|
+
if (this.#startLength === 0) this.#startPwr.resolve([]);
|
|
64
|
+
else this.#run();
|
|
65
|
+
return this.#startPwr.promise;
|
|
66
|
+
}
|
|
67
|
+
#running = 0;
|
|
68
|
+
#run() {
|
|
69
|
+
while (this.limit === 0 || this.#running < this.limit) {
|
|
70
|
+
const task = this.#tasks.shift();
|
|
71
|
+
if (!task) break;
|
|
72
|
+
this.#running++;
|
|
73
|
+
task.afn().then((result) => {
|
|
74
|
+
this.#running--;
|
|
75
|
+
task.pwr?.resolve(result);
|
|
76
|
+
if (task.idx < this.#startLength) {
|
|
77
|
+
this.#startResults[task.idx] = result;
|
|
78
|
+
this.#startResolved++;
|
|
79
|
+
}
|
|
80
|
+
if (this.#startResolved === this.#startLength) this.#startPwr?.resolve(this.#startResults);
|
|
81
|
+
this.#stopResults[task.idx] = result;
|
|
82
|
+
this.#stopResolved++;
|
|
83
|
+
if (this.#stopResolved === this.#stopLength) this.#stopPwr?.resolve(this.#stopResults);
|
|
84
|
+
else this.#run();
|
|
85
|
+
}).catch((reason) => {
|
|
86
|
+
this.#running--;
|
|
87
|
+
task.pwr?.reject(reason);
|
|
88
|
+
if (task.idx < this.#startLength) {
|
|
89
|
+
this.#startRejected++;
|
|
90
|
+
this.#startPwr?.reject(reason);
|
|
91
|
+
}
|
|
92
|
+
if (this.#stopLength > 0) {
|
|
93
|
+
this.#stopRejected++;
|
|
94
|
+
this.#stopPwr?.reject(reason);
|
|
95
|
+
}
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
#stopResolved = 0;
|
|
100
|
+
#stopRejected = 0;
|
|
101
|
+
get stopSettled() {
|
|
102
|
+
return this.#stopResolved === this.#stopLength || this.#stopRejected > 0;
|
|
103
|
+
}
|
|
104
|
+
#stopLength = -1;
|
|
105
|
+
#stopResults = [];
|
|
106
|
+
#stopPwr = null;
|
|
107
|
+
/**
|
|
108
|
+
* 终止队列中的任务执行,终止队列后不再可以追加异步任务
|
|
109
|
+
* @returns 返回一个 Promise,在所有启动任务完成后解析为结果数组
|
|
110
|
+
*/
|
|
111
|
+
async stop() {
|
|
112
|
+
if (this.#stopPwr) return this.#stopPwr.promise;
|
|
113
|
+
this.#stopLength = this.#length;
|
|
114
|
+
this.#stopPwr = Promise.withResolvers();
|
|
115
|
+
if (this.#stopLength === 0) this.#stopPwr.resolve([]);
|
|
116
|
+
else this.#run();
|
|
117
|
+
return this.#stopPwr.promise;
|
|
118
|
+
}
|
|
119
|
+
};
|
|
120
|
+
/**
|
|
121
|
+
* 使用给定的并发限制执行异步函数
|
|
122
|
+
*
|
|
123
|
+
* 此函数的目的是控制一组异步函数的并发执行数量,通过创建一个AsyncQueue实例来管理这些异步函数的执行
|
|
124
|
+
* 它确保在任何给定时间只有最多`limit`数量的异步函数被执行,以避免潜在的性能问题或资源竞争
|
|
125
|
+
*
|
|
126
|
+
* @param asyncFns 一个包含异步函数的数组,每个异步函数都不需要参数,并返回一个Promise
|
|
127
|
+
* @param limit 并发限制的数量,表示同时执行的异步函数的最大数量,0 表示不限制
|
|
128
|
+
* @returns 返回一个Promise,当所有异步函数都执行完毕后,该Promise将被解析
|
|
129
|
+
*/
|
|
132
130
|
function asyncLimit(asyncFns, limit) {
|
|
133
|
-
|
|
134
|
-
return aq.start();
|
|
131
|
+
return new AsyncQueue(asyncFns, { limit }).start();
|
|
135
132
|
}
|
|
133
|
+
/**
|
|
134
|
+
* 创建一个共享执行结果的异步函数
|
|
135
|
+
* @template F - 异步函数类型
|
|
136
|
+
* @param {F} af - 要共享的异步函数
|
|
137
|
+
* @param {AsyncSharedOptions} [options] - 配置选项
|
|
138
|
+
* @returns {F} 返回一个新的异步函数,该函数会共享执行结果
|
|
139
|
+
* @example
|
|
140
|
+
* const fetchData = async (id) => {
|
|
141
|
+
* // 模拟异步操作
|
|
142
|
+
* return await fetch(`/api/data/${id}`);
|
|
143
|
+
* };
|
|
144
|
+
*
|
|
145
|
+
* const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });
|
|
146
|
+
*
|
|
147
|
+
* // 多次调用会共享同一个请求
|
|
148
|
+
* const result1 = await sharedFetch(1);
|
|
149
|
+
* const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果
|
|
150
|
+
*/
|
|
136
151
|
function asyncShared(af, options) {
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
return function sharedAf(...inputs) {
|
|
168
|
-
options?.onTrigger?.(...inputs);
|
|
169
|
-
const p = _sharedAf("trigger", ...inputs);
|
|
170
|
-
p.catch(fnNoop);
|
|
171
|
-
return p;
|
|
172
|
-
};
|
|
152
|
+
let executedPromise;
|
|
153
|
+
let executing = false;
|
|
154
|
+
let executingInputs;
|
|
155
|
+
let executedTime = 0;
|
|
156
|
+
const _sharedAf = async (_from, ...inputs) => {
|
|
157
|
+
executingInputs = inputs;
|
|
158
|
+
if (executing && executedPromise) return executedPromise;
|
|
159
|
+
if (executedPromise && Date.now() - executedTime < (options?.maxAge || 0)) return executedPromise;
|
|
160
|
+
executing = true;
|
|
161
|
+
options?.onExecute?.(...executingInputs);
|
|
162
|
+
executedPromise = af(...executingInputs);
|
|
163
|
+
executingInputs = void 0;
|
|
164
|
+
executedPromise.then((res) => {
|
|
165
|
+
options?.onSuccess?.(res);
|
|
166
|
+
}).catch((err) => {
|
|
167
|
+
options?.onError?.(err);
|
|
168
|
+
}).finally(() => {
|
|
169
|
+
executing = false;
|
|
170
|
+
executedTime = Date.now();
|
|
171
|
+
options?.onFinally?.();
|
|
172
|
+
if (executingInputs && options?.trailing) _sharedAf("trailing", ...executingInputs);
|
|
173
|
+
});
|
|
174
|
+
return executedPromise;
|
|
175
|
+
};
|
|
176
|
+
return function sharedAf(...inputs) {
|
|
177
|
+
options?.onTrigger?.(...inputs);
|
|
178
|
+
const p = _sharedAf("trigger", ...inputs);
|
|
179
|
+
p.catch(fnNoop);
|
|
180
|
+
return p;
|
|
181
|
+
};
|
|
173
182
|
}
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
};
|
|
179
|
-
//# sourceMappingURL=async.mjs.map
|
|
183
|
+
//#endregion
|
|
184
|
+
export { AsyncQueue, asyncLimit, asyncShared };
|
|
185
|
+
|
|
186
|
+
//# sourceMappingURL=async.mjs.map
|
package/dist/async.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"async.mjs","sources":["../src/async.ts"],"sourcesContent":["import { fnNoop } from './function';\nimport type { AnyArray, AnyAsyncFunction } from './types';\n\n/**\n * 表示异步任务的类型\n * @template T - 任务返回值的类型\n */\ntype AsyncTask<T> = {\n /** 任务索引 */\n idx: number;\n /** 异步任务函数 */\n afn: () => Promise<T>;\n /** Promise 的解析器对象 */\n pwr?: PromiseWithResolvers<T>;\n};\n\n/**\n * 异步任务队列的配置选项\n */\nexport type AsyncQueueOptions = {\n /**\n * 并发限制数,0 表示无限制\n * @default 0\n */\n limit?: number;\n};\n\n/**\n * 异步任务队列,用于管理和控制异步任务的执行\n * @template T - 任务返回值的类型\n */\nexport class AsyncQueue<T> {\n #tasks: AsyncTask<T>[] = [];\n #length = 0;\n\n /**\n * 创建一个异步任务队列\n * @param asyncFns - 要执行的异步函数数组\n * @param options - 队列配置选项\n */\n constructor(\n asyncFns: Array<() => Promise<T>>,\n readonly options?: AsyncQueueOptions,\n ) {\n asyncFns.forEach((afn, idx) => {\n this.#add('push', afn);\n });\n }\n\n get length() {\n return this.#length;\n }\n\n get limit() {\n return this.options?.limit || 0;\n }\n\n #add(method: 'unshift' | 'push', afn: () => Promise<T>, pwr?: PromiseWithResolvers<T>) {\n this.#tasks[method]({\n idx: this.#length++,\n afn: afn,\n pwr: pwr,\n });\n }\n\n #addAndRun(method: 'unshift' | 'push', afn: () => Promise<T>) {\n // 明确终止了\n if (this.#stopLength >= 0) {\n throw new Error('异步队列已被终止,无法添加新的任务');\n }\n\n const pwr = Promise.withResolvers<T>();\n this.#add(method, afn, pwr);\n\n if (this.#startPwr && this.#running === 0) {\n this.#run();\n }\n\n return pwr.promise;\n }\n\n async push(afn: () => Promise<T>) {\n return this.#addAndRun('push', afn);\n }\n\n async unshift(afn: () => Promise<T>) {\n return this.#addAndRun('unshift', afn);\n }\n\n #startResolved = 0;\n #startRejected = 0;\n get startSettled() {\n return this.#startResolved === this.#startLength || this.#startRejected > 0;\n }\n\n #startResults: T[] = [];\n #startPwr: PromiseWithResolvers<T[]> | null = null;\n #startLength = 0;\n\n /**\n * 启动队列中的任务执行\n * @returns 返回一个 Promise,在所有启动任务完成后解析为结果数组\n */\n async start(): Promise<T[]> {\n if (this.#startPwr) return this.#startPwr.promise;\n\n // 固化启动时长度,便于判断 start 异步结果\n this.#startLength = this.#length;\n this.#startPwr = Promise.withResolvers<T[]>();\n\n if (this.#startLength === 0) {\n this.#startPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#startPwr.promise;\n }\n\n #running = 0;\n #run() {\n while (this.limit === 0 || this.#running < this.limit) {\n const task = this.#tasks.shift();\n\n // 无任务可执行\n if (!task) break;\n\n this.#running++;\n\n task\n .afn()\n .then((result) => {\n this.#running--;\n task.pwr?.resolve(result);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startResults[task.idx] = result;\n this.#startResolved++;\n }\n\n // 所有启动任务都已执行完毕\n if (this.#startResolved === this.#startLength) {\n this.#startPwr?.resolve(this.#startResults);\n }\n\n this.#stopResults[task.idx] = result;\n this.#stopResolved++;\n\n // 所有停止任务都已执行完毕\n if (this.#stopResolved === this.#stopLength) {\n this.#stopPwr?.resolve(this.#stopResults);\n } else {\n this.#run();\n }\n })\n .catch((reason) => {\n this.#running--;\n task.pwr?.reject(reason);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startRejected++;\n this.#startPwr?.reject(reason);\n }\n\n // 属于停止任务\n if (this.#stopLength > 0) {\n this.#stopRejected++;\n this.#stopPwr?.reject(reason);\n }\n });\n }\n }\n #stopResolved = 0;\n #stopRejected = 0;\n get stopSettled() {\n return this.#stopResolved === this.#stopLength || this.#stopRejected > 0;\n }\n\n #stopLength = -1;\n #stopResults: T[] = [];\n\n #stopPwr?: PromiseWithResolvers<T[]> | null = null;\n\n /**\n * 终止队列中的任务执行,终止队列后不再可以追加异步任务\n * @returns 返回一个 Promise,在所有启动任务完成后解析为结果数组\n */\n async stop() {\n if (this.#stopPwr) {\n return this.#stopPwr.promise;\n }\n\n this.#stopLength = this.#length;\n this.#stopPwr = Promise.withResolvers<T[]>();\n\n if (this.#stopLength === 0) {\n this.#stopPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#stopPwr.promise;\n }\n}\n\n/**\n * 使用给定的并发限制执行异步函数\n *\n * 此函数的目的是控制一组异步函数的并发执行数量,通过创建一个AsyncQueue实例来管理这些异步函数的执行\n * 它确保在任何给定时间只有最多`limit`数量的异步函数被执行,以避免潜在的性能问题或资源竞争\n *\n * @param asyncFns 一个包含异步函数的数组,每个异步函数都不需要参数,并返回一个Promise\n * @param limit 并发限制的数量,表示同时执行的异步函数的最大数量,0 表示不限制\n * @returns 返回一个Promise,当所有异步函数都执行完毕后,该Promise将被解析\n */\nexport function asyncLimit<T>(asyncFns: Array<() => Promise<T>>, limit: number) {\n const aq = new AsyncQueue<T>(asyncFns, { limit });\n return aq.start();\n}\n\n/**\n * 异步共享函数的配置选项\n */\nexport type AsyncSharedOptions<I extends AnyArray, O> = {\n /**\n * 是否在调用结束后再执行(只在运行期间有再次调用时才会生效)\n * @type {boolean}\n * @default false\n * @example\n * const sharedFn = asyncShared(fetchData, { trailing: true });\n * // 如果在 fetchData 执行期间多次调用 sharedFn,则会在 fetchData 结束后再次执行\n */\n trailing?: boolean;\n\n /**\n * 缓存结果的最大有效期(毫秒)\n * @type {number}\n * @example\n * const sharedFn = asyncShared(fetchData, { maxAge: 1000 });\n * // 在 1 秒内调用 sharedFn 会直接返回缓存结果\n */\n maxAge?: number;\n\n /**\n * 在调用共享函数时触发的回调函数\n * @param inputs - 传递给共享函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onTrigger: (...args) => console.log('Calling with:', args)\n * };\n */\n onTrigger?: (...inputs: I) => unknown;\n\n /**\n * 在执行异步函数时触发的回调函数\n * @param args - 传递给异步函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onExecute: (...args) => console.log('Executing with:', args)\n * };\n */\n onExecute?: (...args: I) => unknown;\n\n /**\n * 在异步函数成功执行后触发的回调函数\n * @param output - 异步函数的返回结果\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onSuccess: (result) => console.log('Success:', result)\n * };\n */\n onSuccess?: (output: O) => unknown;\n\n /**\n * 在异步函数执行失败时触发的回调函数\n * @param error - 异步函数抛出的错误\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onError: (error) => console.error('Error:', error)\n * };\n */\n onError?: (error: unknown) => unknown;\n\n /**\n * 在异步函数执行完成(无论成功或失败)时触发的回调函数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onFinally: () => console.log('Execution completed')\n * };\n */\n onFinally?: () => unknown;\n};\n\n/**\n * 创建一个共享执行结果的异步函数\n * @template F - 异步函数类型\n * @param {F} af - 要共享的异步函数\n * @param {AsyncSharedOptions} [options] - 配置选项\n * @returns {F} 返回一个新的异步函数,该函数会共享执行结果\n * @example\n * const fetchData = async (id) => {\n * // 模拟异步操作\n * return await fetch(`/api/data/${id}`);\n * };\n *\n * const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });\n *\n * // 多次调用会共享同一个请求\n * const result1 = await sharedFetch(1);\n * const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果\n */\nexport function asyncShared<I extends AnyArray, O>(\n af: (...inputs: I) => Promise<O>,\n options?: AsyncSharedOptions<I, O>,\n) {\n let executedPromise: Promise<O> | undefined;\n let executing = false;\n let executingInputs: I | undefined;\n let executedTime = 0;\n\n const _sharedAf = async (from: 'trigger' | 'trailing', ...inputs: I) => {\n executingInputs = inputs;\n\n // 如果正在运行,则复用运行结果\n if (executing && executedPromise) {\n return executedPromise;\n }\n\n // 如果已运行结束空闲时,判断是否在等待时间内\n if (executedPromise && Date.now() - executedTime < (options?.maxAge || 0)) {\n return executedPromise;\n }\n\n // 否则直接执行\n executing = true;\n options?.onExecute?.(...executingInputs);\n executedPromise = af(...executingInputs);\n executingInputs = undefined;\n executedPromise\n .then((res) => {\n options?.onSuccess?.(res);\n })\n .catch((err) => {\n options?.onError?.(err);\n })\n .finally(() => {\n executing = false;\n executedTime = Date.now();\n options?.onFinally?.();\n\n // 执行期间多次调用,则重新执行\n if (executingInputs && options?.trailing) {\n _sharedAf('trailing', ...executingInputs);\n }\n });\n\n return executedPromise;\n };\n\n return function sharedAf(...inputs: I): Promise<O> {\n options?.onTrigger?.(...inputs);\n const p = _sharedAf('trigger', ...inputs);\n // 必须捕获错误,否则单测错误边界时会抛错\n p.catch(fnNoop);\n return p;\n };\n}\n\n// const af1 = asyncShared(async () => {\n// return 1;\n// });\n// const n = await af1();\n\n// const af2 = asyncShared(async (a: number) => {\n// return a + 1;\n// });\n// const n2 = await af2(2);\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"async.mjs","names":["#add","#length","#tasks","#stopLength","#startPwr","#running","#run","#addAndRun","#startResolved","#startLength","#startRejected","#startResults","#stopResults","#stopResolved","#stopPwr","#stopRejected"],"sources":["../src/async.ts"],"sourcesContent":["import { fnNoop } from './function';\nimport type { AnyArray } from './types';\n\n/**\n * 表示异步任务的类型\n * @template T - 任务返回值的类型\n */\ntype AsyncTask<T> = {\n /** 任务索引 */\n idx: number;\n /** 异步任务函数 */\n afn: () => Promise<T>;\n /** Promise 的解析器对象 */\n pwr?: PromiseWithResolvers<T>;\n};\n\n/**\n * 异步任务队列的配置选项\n */\nexport type AsyncQueueOptions = {\n /**\n * 并发限制数,0 表示无限制\n * @default 0\n */\n limit?: number;\n};\n\n/**\n * 异步任务队列,用于管理和控制异步任务的执行\n * @template T - 任务返回值的类型\n */\nexport class AsyncQueue<T> {\n #tasks: AsyncTask<T>[] = [];\n #length = 0;\n\n /**\n * 创建一个异步任务队列\n * @param asyncFns - 要执行的异步函数数组\n * @param options - 队列配置选项\n */\n constructor(\n asyncFns: Array<() => Promise<T>>,\n readonly options?: AsyncQueueOptions,\n ) {\n asyncFns.forEach((afn, _idx) => {\n this.#add('push', afn);\n });\n }\n\n get length() {\n return this.#length;\n }\n\n get limit() {\n return this.options?.limit || 0;\n }\n\n #add(method: 'unshift' | 'push', afn: () => Promise<T>, pwr?: PromiseWithResolvers<T>) {\n this.#tasks[method]({\n idx: this.#length++,\n afn: afn,\n pwr: pwr,\n });\n }\n\n #addAndRun(method: 'unshift' | 'push', afn: () => Promise<T>) {\n // 明确终止了\n if (this.#stopLength >= 0) {\n throw new Error('异步队列已被终止,无法添加新的任务');\n }\n\n const pwr = Promise.withResolvers<T>();\n this.#add(method, afn, pwr);\n\n if (this.#startPwr && this.#running === 0) {\n this.#run();\n }\n\n return pwr.promise;\n }\n\n async push(afn: () => Promise<T>) {\n return this.#addAndRun('push', afn);\n }\n\n async unshift(afn: () => Promise<T>) {\n return this.#addAndRun('unshift', afn);\n }\n\n #startResolved = 0;\n #startRejected = 0;\n get startSettled() {\n return this.#startResolved === this.#startLength || this.#startRejected > 0;\n }\n\n #startResults: T[] = [];\n #startPwr: PromiseWithResolvers<T[]> | null = null;\n #startLength = 0;\n\n /**\n * 启动队列中的任务执行\n * @returns 返回一个 Promise,在所有启动任务完成后解析为结果数组\n */\n async start(): Promise<T[]> {\n if (this.#startPwr) return this.#startPwr.promise;\n\n // 固化启动时长度,便于判断 start 异步结果\n this.#startLength = this.#length;\n this.#startPwr = Promise.withResolvers<T[]>();\n\n if (this.#startLength === 0) {\n this.#startPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#startPwr.promise;\n }\n\n #running = 0;\n #run() {\n while (this.limit === 0 || this.#running < this.limit) {\n const task = this.#tasks.shift();\n\n // 无任务可执行\n if (!task) break;\n\n this.#running++;\n\n task\n .afn()\n .then((result) => {\n this.#running--;\n task.pwr?.resolve(result);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startResults[task.idx] = result;\n this.#startResolved++;\n }\n\n // 所有启动任务都已执行完毕\n if (this.#startResolved === this.#startLength) {\n this.#startPwr?.resolve(this.#startResults);\n }\n\n this.#stopResults[task.idx] = result;\n this.#stopResolved++;\n\n // 所有停止任务都已执行完毕\n if (this.#stopResolved === this.#stopLength) {\n this.#stopPwr?.resolve(this.#stopResults);\n } else {\n this.#run();\n }\n })\n .catch((reason) => {\n this.#running--;\n task.pwr?.reject(reason);\n\n // 属于启动任务\n if (task.idx < this.#startLength) {\n this.#startRejected++;\n this.#startPwr?.reject(reason);\n }\n\n // 属于停止任务\n if (this.#stopLength > 0) {\n this.#stopRejected++;\n this.#stopPwr?.reject(reason);\n }\n });\n }\n }\n #stopResolved = 0;\n #stopRejected = 0;\n get stopSettled() {\n return this.#stopResolved === this.#stopLength || this.#stopRejected > 0;\n }\n\n #stopLength = -1;\n #stopResults: T[] = [];\n\n #stopPwr?: PromiseWithResolvers<T[]> | null = null;\n\n /**\n * 终止队列中的任务执行,终止队列后不再可以追加异步任务\n * @returns 返回一个 Promise,在所有启动任务完成后解析为结果数组\n */\n async stop() {\n if (this.#stopPwr) {\n return this.#stopPwr.promise;\n }\n\n this.#stopLength = this.#length;\n this.#stopPwr = Promise.withResolvers<T[]>();\n\n if (this.#stopLength === 0) {\n this.#stopPwr.resolve([]);\n } else {\n this.#run();\n }\n\n return this.#stopPwr.promise;\n }\n}\n\n/**\n * 使用给定的并发限制执行异步函数\n *\n * 此函数的目的是控制一组异步函数的并发执行数量,通过创建一个AsyncQueue实例来管理这些异步函数的执行\n * 它确保在任何给定时间只有最多`limit`数量的异步函数被执行,以避免潜在的性能问题或资源竞争\n *\n * @param asyncFns 一个包含异步函数的数组,每个异步函数都不需要参数,并返回一个Promise\n * @param limit 并发限制的数量,表示同时执行的异步函数的最大数量,0 表示不限制\n * @returns 返回一个Promise,当所有异步函数都执行完毕后,该Promise将被解析\n */\nexport function asyncLimit<T>(asyncFns: Array<() => Promise<T>>, limit: number) {\n const aq = new AsyncQueue<T>(asyncFns, { limit });\n return aq.start();\n}\n\n/**\n * 异步共享函数的配置选项\n */\nexport type AsyncSharedOptions<I extends AnyArray, O> = {\n /**\n * 是否在调用结束后再执行(只在运行期间有再次调用时才会生效)\n * @type {boolean}\n * @default false\n * @example\n * const sharedFn = asyncShared(fetchData, { trailing: true });\n * // 如果在 fetchData 执行期间多次调用 sharedFn,则会在 fetchData 结束后再次执行\n */\n trailing?: boolean;\n\n /**\n * 缓存结果的最大有效期(毫秒)\n * @type {number}\n * @example\n * const sharedFn = asyncShared(fetchData, { maxAge: 1000 });\n * // 在 1 秒内调用 sharedFn 会直接返回缓存结果\n */\n maxAge?: number;\n\n /**\n * 在调用共享函数时触发的回调函数\n * @param inputs - 传递给共享函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onTrigger: (...args) => console.log('Calling with:', args)\n * };\n */\n onTrigger?: (...inputs: I) => unknown;\n\n /**\n * 在执行异步函数时触发的回调函数\n * @param args - 传递给异步函数的参数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onExecute: (...args) => console.log('Executing with:', args)\n * };\n */\n onExecute?: (...args: I) => unknown;\n\n /**\n * 在异步函数成功执行后触发的回调函数\n * @param output - 异步函数的返回结果\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onSuccess: (result) => console.log('Success:', result)\n * };\n */\n onSuccess?: (output: O) => unknown;\n\n /**\n * 在异步函数执行失败时触发的回调函数\n * @param error - 异步函数抛出的错误\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onError: (error) => console.error('Error:', error)\n * };\n */\n onError?: (error: unknown) => unknown;\n\n /**\n * 在异步函数执行完成(无论成功或失败)时触发的回调函数\n * @example\n * const options: AsyncSharedOptions<typeof fetchData> = {\n * onFinally: () => console.log('Execution completed')\n * };\n */\n onFinally?: () => unknown;\n};\n\n/**\n * 创建一个共享执行结果的异步函数\n * @template F - 异步函数类型\n * @param {F} af - 要共享的异步函数\n * @param {AsyncSharedOptions} [options] - 配置选项\n * @returns {F} 返回一个新的异步函数,该函数会共享执行结果\n * @example\n * const fetchData = async (id) => {\n * // 模拟异步操作\n * return await fetch(`/api/data/${id}`);\n * };\n *\n * const sharedFetch = asyncShared(fetchData, { maxAge: 1000 });\n *\n * // 多次调用会共享同一个请求\n * const result1 = await sharedFetch(1);\n * const result2 = await sharedFetch(1); // 上次请求完成后 1000ms 内直接返回缓存结果\n */\nexport function asyncShared<I extends AnyArray, O>(\n af: (...inputs: I) => Promise<O>,\n options?: AsyncSharedOptions<I, O>,\n) {\n let executedPromise: Promise<O> | undefined;\n let executing = false;\n let executingInputs: I | undefined;\n let executedTime = 0;\n\n const _sharedAf = async (_from: 'trigger' | 'trailing', ...inputs: I) => {\n executingInputs = inputs;\n\n // 如果正在运行,则复用运行结果\n if (executing && executedPromise) {\n return executedPromise;\n }\n\n // 如果已运行结束空闲时,判断是否在等待时间内\n if (executedPromise && Date.now() - executedTime < (options?.maxAge || 0)) {\n return executedPromise;\n }\n\n // 否则直接执行\n executing = true;\n options?.onExecute?.(...executingInputs);\n executedPromise = af(...executingInputs);\n executingInputs = undefined;\n executedPromise\n .then((res) => {\n options?.onSuccess?.(res);\n })\n .catch((err) => {\n options?.onError?.(err);\n })\n .finally(() => {\n executing = false;\n executedTime = Date.now();\n options?.onFinally?.();\n\n // 执行期间多次调用,则重新执行\n if (executingInputs && options?.trailing) {\n _sharedAf('trailing', ...executingInputs);\n }\n });\n\n return executedPromise;\n };\n\n return function sharedAf(...inputs: I): Promise<O> {\n options?.onTrigger?.(...inputs);\n const p = _sharedAf('trigger', ...inputs);\n // 必须捕获错误,否则单测错误边界时会抛错\n p.catch(fnNoop);\n return p;\n };\n}\n\n// const af1 = asyncShared(async () => {\n// return 1;\n// });\n// const n = await af1();\n\n// const af2 = asyncShared(async (a: number) => {\n// return a + 1;\n// });\n// const n2 = await af2(2);\n"],"mappings":"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"}
|
package/dist/base64.cjs
CHANGED
|
@@ -1,16 +1,20 @@
|
|
|
1
|
-
"use strict";
|
|
2
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
//#region src/base64.ts
|
|
3
|
+
/**
|
|
4
|
+
* base64 转换为 Blob 实例
|
|
5
|
+
* @ref http://stackoverflow.com/q/18253378
|
|
6
|
+
* @param base64 {String} base64 编码
|
|
7
|
+
* @returns {Blob}
|
|
8
|
+
*/
|
|
3
9
|
function base64toBlob(base64) {
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
}
|
|
11
|
-
return new Blob([ab], {
|
|
12
|
-
type: mimeString
|
|
13
|
-
});
|
|
10
|
+
const byteString = atob(base64.split(",")[1]);
|
|
11
|
+
const mimeString = base64.split(",")[0].split(":")[1].split(";")[0];
|
|
12
|
+
const ab = new ArrayBuffer(byteString.length);
|
|
13
|
+
const ua = new Uint8Array(ab);
|
|
14
|
+
for (let i = 0; i < byteString.length; i++) ua[i] = byteString.charCodeAt(i);
|
|
15
|
+
return new Blob([ab], { type: mimeString });
|
|
14
16
|
}
|
|
17
|
+
//#endregion
|
|
15
18
|
exports.base64toBlob = base64toBlob;
|
|
16
|
-
|
|
19
|
+
|
|
20
|
+
//# sourceMappingURL=base64.cjs.map
|
package/dist/base64.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base64.cjs","sources":["../src/base64.ts"],"sourcesContent":["/**\n * base64 转换为 Blob 实例\n * @ref http://stackoverflow.com/q/18253378\n * @param base64 {String} base64 编码\n * @returns {Blob}\n */\nexport function base64toBlob(base64: string): Blob {\n const byteString = atob(base64.split(',')[1]);\n const mimeString = base64.split(',')[0].split(':')[1].split(';')[0];\n const ab = new ArrayBuffer(byteString.length);\n const ua = new Uint8Array(ab);\n\n for (let i = 0; i < byteString.length; i++) {\n ua[i] = byteString.charCodeAt(i);\n }\n\n return new Blob([ab], {\n type: mimeString,\n });\n}\n"],"
|
|
1
|
+
{"version":3,"file":"base64.cjs","names":[],"sources":["../src/base64.ts"],"sourcesContent":["/**\n * base64 转换为 Blob 实例\n * @ref http://stackoverflow.com/q/18253378\n * @param base64 {String} base64 编码\n * @returns {Blob}\n */\nexport function base64toBlob(base64: string): Blob {\n const byteString = atob(base64.split(',')[1]);\n const mimeString = base64.split(',')[0].split(':')[1].split(';')[0];\n const ab = new ArrayBuffer(byteString.length);\n const ua = new Uint8Array(ab);\n\n for (let i = 0; i < byteString.length; i++) {\n ua[i] = byteString.charCodeAt(i);\n }\n\n return new Blob([ab], {\n type: mimeString,\n });\n}\n"],"mappings":";;;;;;;;AAMA,SAAgB,aAAa,QAAsB;CACjD,MAAM,aAAa,KAAK,OAAO,MAAM,IAAI,CAAC,GAAG;CAC7C,MAAM,aAAa,OAAO,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CACjE,MAAM,KAAK,IAAI,YAAY,WAAW,OAAO;CAC7C,MAAM,KAAK,IAAI,WAAW,GAAG;CAE7B,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KACrC,GAAG,KAAK,WAAW,WAAW,EAAE;CAGlC,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EACpB,MAAM,YACP,CAAC"}
|
package/dist/base64.mjs
CHANGED
|
@@ -1,16 +1,19 @@
|
|
|
1
|
+
//#region src/base64.ts
|
|
2
|
+
/**
|
|
3
|
+
* base64 转换为 Blob 实例
|
|
4
|
+
* @ref http://stackoverflow.com/q/18253378
|
|
5
|
+
* @param base64 {String} base64 编码
|
|
6
|
+
* @returns {Blob}
|
|
7
|
+
*/
|
|
1
8
|
function base64toBlob(base64) {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
}
|
|
9
|
-
return new Blob([ab], {
|
|
10
|
-
type: mimeString
|
|
11
|
-
});
|
|
9
|
+
const byteString = atob(base64.split(",")[1]);
|
|
10
|
+
const mimeString = base64.split(",")[0].split(":")[1].split(";")[0];
|
|
11
|
+
const ab = new ArrayBuffer(byteString.length);
|
|
12
|
+
const ua = new Uint8Array(ab);
|
|
13
|
+
for (let i = 0; i < byteString.length; i++) ua[i] = byteString.charCodeAt(i);
|
|
14
|
+
return new Blob([ab], { type: mimeString });
|
|
12
15
|
}
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
//# sourceMappingURL=base64.mjs.map
|
|
16
|
+
//#endregion
|
|
17
|
+
export { base64toBlob };
|
|
18
|
+
|
|
19
|
+
//# sourceMappingURL=base64.mjs.map
|
package/dist/base64.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base64.mjs","sources":["../src/base64.ts"],"sourcesContent":["/**\n * base64 转换为 Blob 实例\n * @ref http://stackoverflow.com/q/18253378\n * @param base64 {String} base64 编码\n * @returns {Blob}\n */\nexport function base64toBlob(base64: string): Blob {\n const byteString = atob(base64.split(',')[1]);\n const mimeString = base64.split(',')[0].split(':')[1].split(';')[0];\n const ab = new ArrayBuffer(byteString.length);\n const ua = new Uint8Array(ab);\n\n for (let i = 0; i < byteString.length; i++) {\n ua[i] = byteString.charCodeAt(i);\n }\n\n return new Blob([ab], {\n type: mimeString,\n });\n}\n"],"
|
|
1
|
+
{"version":3,"file":"base64.mjs","names":[],"sources":["../src/base64.ts"],"sourcesContent":["/**\n * base64 转换为 Blob 实例\n * @ref http://stackoverflow.com/q/18253378\n * @param base64 {String} base64 编码\n * @returns {Blob}\n */\nexport function base64toBlob(base64: string): Blob {\n const byteString = atob(base64.split(',')[1]);\n const mimeString = base64.split(',')[0].split(':')[1].split(';')[0];\n const ab = new ArrayBuffer(byteString.length);\n const ua = new Uint8Array(ab);\n\n for (let i = 0; i < byteString.length; i++) {\n ua[i] = byteString.charCodeAt(i);\n }\n\n return new Blob([ab], {\n type: mimeString,\n });\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,aAAa,QAAsB;CACjD,MAAM,aAAa,KAAK,OAAO,MAAM,IAAI,CAAC,GAAG;CAC7C,MAAM,aAAa,OAAO,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CACjE,MAAM,KAAK,IAAI,YAAY,WAAW,OAAO;CAC7C,MAAM,KAAK,IAAI,WAAW,GAAG;CAE7B,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KACrC,GAAG,KAAK,WAAW,WAAW,EAAE;CAGlC,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EACpB,MAAM,YACP,CAAC"}
|