@simplysm/core-common 13.0.99 → 14.0.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/dist/common.types.d.ts +14 -14
- package/dist/common.types.js +2 -1
- package/dist/common.types.js.map +1 -6
- package/dist/env.d.ts +5 -0
- package/dist/env.d.ts.map +1 -1
- package/dist/env.js +12 -8
- package/dist/env.js.map +1 -6
- package/dist/errors/argument-error.d.ts +10 -10
- package/dist/errors/argument-error.d.ts.map +1 -1
- package/dist/errors/argument-error.js +31 -14
- package/dist/errors/argument-error.js.map +1 -6
- package/dist/errors/not-implemented-error.d.ts +8 -8
- package/dist/errors/not-implemented-error.js +30 -12
- package/dist/errors/not-implemented-error.js.map +1 -6
- package/dist/errors/sd-error.d.ts +10 -10
- package/dist/errors/sd-error.d.ts.map +1 -1
- package/dist/errors/sd-error.js +45 -24
- package/dist/errors/sd-error.js.map +1 -6
- package/dist/errors/timeout-error.d.ts +10 -10
- package/dist/errors/timeout-error.js +34 -15
- package/dist/errors/timeout-error.js.map +1 -6
- package/dist/extensions/arr-ext.d.ts +2 -2
- package/dist/extensions/arr-ext.helpers.d.ts +10 -10
- package/dist/extensions/arr-ext.helpers.js +112 -89
- package/dist/extensions/arr-ext.helpers.js.map +1 -6
- package/dist/extensions/arr-ext.js +458 -422
- package/dist/extensions/arr-ext.js.map +1 -6
- package/dist/extensions/arr-ext.types.d.ts +57 -57
- package/dist/extensions/arr-ext.types.d.ts.map +1 -1
- package/dist/extensions/arr-ext.types.js +6 -1
- package/dist/extensions/arr-ext.types.js.map +1 -6
- package/dist/extensions/map-ext.d.ts +16 -16
- package/dist/extensions/map-ext.js +27 -22
- package/dist/extensions/map-ext.js.map +1 -6
- package/dist/extensions/set-ext.d.ts +11 -11
- package/dist/extensions/set-ext.js +32 -25
- package/dist/extensions/set-ext.js.map +1 -6
- package/dist/features/debounce-queue.d.ts +17 -17
- package/dist/features/debounce-queue.js +98 -70
- package/dist/features/debounce-queue.js.map +1 -6
- package/dist/features/event-emitter.d.ts +20 -20
- package/dist/features/event-emitter.js +101 -78
- package/dist/features/event-emitter.js.map +1 -6
- package/dist/features/serial-queue.d.ts +11 -11
- package/dist/features/serial-queue.js +78 -57
- package/dist/features/serial-queue.js.map +1 -6
- package/dist/globals.d.ts +4 -4
- package/dist/globals.js +9 -1
- package/dist/globals.js.map +1 -6
- package/dist/index.js +28 -27
- package/dist/index.js.map +1 -6
- package/dist/types/date-only.d.ts +64 -64
- package/dist/types/date-only.d.ts.map +1 -1
- package/dist/types/date-only.js +263 -252
- package/dist/types/date-only.js.map +1 -6
- package/dist/types/date-time.d.ts +36 -36
- package/dist/types/date-time.d.ts.map +1 -1
- package/dist/types/date-time.js +196 -288
- package/dist/types/date-time.js.map +1 -6
- package/dist/types/lazy-gc-map.d.ts +26 -26
- package/dist/types/lazy-gc-map.d.ts.map +1 -1
- package/dist/types/lazy-gc-map.js +202 -159
- package/dist/types/lazy-gc-map.js.map +1 -6
- package/dist/types/time.d.ts +23 -23
- package/dist/types/time.d.ts.map +1 -1
- package/dist/types/time.js +169 -158
- package/dist/types/time.js.map +1 -6
- package/dist/types/uuid.d.ts +11 -11
- package/dist/types/uuid.d.ts.map +1 -1
- package/dist/types/uuid.js +95 -70
- package/dist/types/uuid.js.map +1 -6
- package/dist/utils/bytes.d.ts +17 -17
- package/dist/utils/bytes.js +137 -81
- package/dist/utils/bytes.js.map +1 -6
- package/dist/utils/date-format.d.ts +40 -40
- package/dist/utils/date-format.js +187 -101
- package/dist/utils/date-format.js.map +1 -6
- package/dist/utils/error.d.ts +4 -4
- package/dist/utils/error.js +11 -6
- package/dist/utils/error.js.map +1 -6
- package/dist/utils/json.d.ts +19 -19
- package/dist/utils/json.js +187 -135
- package/dist/utils/json.js.map +1 -6
- package/dist/utils/num.d.ts +20 -20
- package/dist/utils/num.js +76 -34
- package/dist/utils/num.js.map +1 -6
- package/dist/utils/obj.d.ts +111 -111
- package/dist/utils/obj.d.ts.map +1 -1
- package/dist/utils/obj.js +706 -496
- package/dist/utils/obj.js.map +1 -6
- package/dist/utils/path.d.ts +10 -10
- package/dist/utils/path.js +35 -18
- package/dist/utils/path.js.map +1 -6
- package/dist/utils/primitive.d.ts +5 -5
- package/dist/utils/primitive.js +34 -14
- package/dist/utils/primitive.js.map +1 -6
- package/dist/utils/str.d.ts +38 -38
- package/dist/utils/str.js +217 -113
- package/dist/utils/str.js.map +1 -6
- package/dist/utils/template-strings.d.ts +26 -26
- package/dist/utils/template-strings.js +113 -40
- package/dist/utils/template-strings.js.map +1 -6
- package/dist/utils/transferable.d.ts +18 -18
- package/dist/utils/transferable.js +218 -151
- package/dist/utils/transferable.js.map +1 -6
- package/dist/utils/wait.d.ts +9 -9
- package/dist/utils/wait.js +30 -15
- package/dist/utils/wait.js.map +1 -6
- package/dist/utils/xml.d.ts +13 -13
- package/dist/utils/xml.js +84 -46
- package/dist/utils/xml.js.map +1 -6
- package/dist/utils/zip.d.ts +22 -22
- package/dist/utils/zip.js +172 -148
- package/dist/utils/zip.js.map +1 -6
- package/package.json +5 -7
- package/src/common.types.ts +14 -14
- package/src/env.ts +9 -1
- package/src/errors/argument-error.ts +15 -15
- package/src/errors/not-implemented-error.ts +9 -9
- package/src/errors/sd-error.ts +12 -12
- package/src/errors/timeout-error.ts +12 -12
- package/src/extensions/arr-ext.helpers.ts +16 -16
- package/src/extensions/arr-ext.ts +35 -35
- package/src/extensions/arr-ext.types.ts +57 -57
- package/src/extensions/map-ext.ts +16 -16
- package/src/extensions/set-ext.ts +11 -11
- package/src/features/debounce-queue.ts +23 -23
- package/src/features/event-emitter.ts +25 -25
- package/src/features/serial-queue.ts +13 -13
- package/src/globals.ts +4 -4
- package/src/index.ts +5 -5
- package/src/types/date-only.ts +84 -83
- package/src/types/date-time.ts +43 -42
- package/src/types/lazy-gc-map.ts +44 -44
- package/src/types/time.ts +29 -29
- package/src/types/uuid.ts +15 -15
- package/src/utils/bytes.ts +35 -35
- package/src/utils/date-format.ts +59 -59
- package/src/utils/error.ts +4 -4
- package/src/utils/json.ts +41 -41
- package/src/utils/num.ts +20 -20
- package/src/utils/obj.ts +138 -138
- package/src/utils/path.ts +10 -10
- package/src/utils/primitive.ts +6 -6
- package/src/utils/str.ts +48 -48
- package/src/utils/template-strings.ts +29 -29
- package/src/utils/transferable.ts +38 -38
- package/src/utils/wait.ts +10 -10
- package/src/utils/xml.ts +19 -19
- package/src/utils/zip.ts +25 -25
- package/README.md +0 -160
- package/docs/errors.md +0 -119
- package/docs/extensions.md +0 -387
- package/docs/features.md +0 -143
- package/docs/types.md +0 -287
- package/docs/utils.md +0 -757
- package/tests/errors/errors.spec.ts +0 -80
- package/tests/extensions/array-extension.spec.ts +0 -654
- package/tests/extensions/map-extension.spec.ts +0 -117
- package/tests/extensions/set-extension.spec.ts +0 -67
- package/tests/types/date-only.spec.ts +0 -533
- package/tests/types/date-time.spec.ts +0 -246
- package/tests/types/lazy-gc-map.spec.ts +0 -606
- package/tests/types/time.spec.ts +0 -428
- package/tests/types/uuid.spec.ts +0 -74
- package/tests/utils/bytes-utils.spec.ts +0 -197
- package/tests/utils/date-format.spec.ts +0 -350
- package/tests/utils/debounce-queue.spec.ts +0 -226
- package/tests/utils/json.spec.ts +0 -400
- package/tests/utils/number.spec.ts +0 -136
- package/tests/utils/object.spec.ts +0 -810
- package/tests/utils/path.spec.ts +0 -70
- package/tests/utils/primitive.spec.ts +0 -43
- package/tests/utils/sd-event-emitter.spec.ts +0 -189
- package/tests/utils/serial-queue.spec.ts +0 -305
- package/tests/utils/string.spec.ts +0 -265
- package/tests/utils/template-strings.spec.ts +0 -48
- package/tests/utils/transferable.spec.ts +0 -639
- package/tests/utils/wait.spec.ts +0 -123
- package/tests/utils/xml.spec.ts +0 -146
- package/tests/utils/zip.spec.ts +0 -221
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
2
|
+
* 자동 만료 기능이 있는 Map
|
|
3
|
+
* LRU 방식으로 접근 시간을 갱신하고, 지정된 시간 동안 접근하지 않으면 자동 삭제
|
|
4
4
|
*
|
|
5
|
-
* @note
|
|
6
|
-
*
|
|
5
|
+
* @note 사용 후 반드시 dispose()를 호출하거나 'using' 문을 사용해야 함.
|
|
6
|
+
* 그렇지 않으면 GC 타이머가 계속 실행되어 메모리 누수 발생.
|
|
7
7
|
*
|
|
8
8
|
* @example
|
|
9
|
-
* // using
|
|
9
|
+
* // using 문 (권장)
|
|
10
10
|
* using map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 });
|
|
11
11
|
*
|
|
12
|
-
* //
|
|
12
|
+
* // 또는 명시적 dispose() 호출
|
|
13
13
|
* const map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 });
|
|
14
14
|
* try {
|
|
15
|
-
* // ...
|
|
15
|
+
* // ... 사용
|
|
16
16
|
* } finally {
|
|
17
17
|
* map.dispose();
|
|
18
18
|
* }
|
|
@@ -25,46 +25,46 @@ export declare class LazyGcMap<TKey, TValue> {
|
|
|
25
25
|
private _isGcRunning;
|
|
26
26
|
private _isDestroyed;
|
|
27
27
|
/**
|
|
28
|
-
* @param _options
|
|
29
|
-
* @param _options.gcInterval GC
|
|
30
|
-
* @param _options.expireTime
|
|
31
|
-
* @param _options.onExpire
|
|
28
|
+
* @param _options 설정 옵션
|
|
29
|
+
* @param _options.gcInterval GC 간격 (밀리초). 기본값: expireTime의 1/10 (최소 1000ms)
|
|
30
|
+
* @param _options.expireTime 만료 시간 (밀리초). 마지막 접근 이후 이 시간이 지나면 삭제됨. 예: 60000 (60초)
|
|
31
|
+
* @param _options.onExpire 만료 시 호출되는 콜백. 비동기 함수 가능, 에러 발생 시 로그 출력 후 계속 실행
|
|
32
32
|
*/
|
|
33
33
|
constructor(_options: {
|
|
34
34
|
gcInterval?: number;
|
|
35
35
|
expireTime: number;
|
|
36
36
|
onExpire?: (key: TKey, value: TValue) => void | Promise<void>;
|
|
37
37
|
});
|
|
38
|
-
/**
|
|
38
|
+
/** 저장된 항목 수 */
|
|
39
39
|
get size(): number;
|
|
40
|
-
/**
|
|
40
|
+
/** key 존재 여부 확인 (접근 시간 갱신하지 않음) */
|
|
41
41
|
has(key: TKey): boolean;
|
|
42
|
-
/**
|
|
42
|
+
/** 값 조회 (접근 시간 갱신) */
|
|
43
43
|
get(key: TKey): TValue | undefined;
|
|
44
|
-
/**
|
|
44
|
+
/** 값 저장 (접근 시간 설정 및 GC 타이머 시작) */
|
|
45
45
|
set(key: TKey, value: TValue): void;
|
|
46
|
-
/**
|
|
46
|
+
/** 항목 삭제 (비어있으면 GC 타이머 중지) */
|
|
47
47
|
delete(key: TKey): boolean;
|
|
48
|
-
/**
|
|
48
|
+
/** 인스턴스 정리 (GC 타이머 중지 및 데이터 삭제) */
|
|
49
49
|
dispose(): void;
|
|
50
|
-
/**
|
|
50
|
+
/** 'using' 문 지원 */
|
|
51
51
|
[Symbol.dispose](): void;
|
|
52
52
|
/**
|
|
53
|
-
*
|
|
53
|
+
* 모든 항목 삭제 (인스턴스는 계속 사용 가능)
|
|
54
54
|
*/
|
|
55
55
|
clear(): void;
|
|
56
56
|
/**
|
|
57
|
-
*
|
|
58
|
-
* @param key
|
|
59
|
-
* @param factory
|
|
60
|
-
* @returns
|
|
57
|
+
* key에 대한 값을 반환하거나, 없으면 팩토리로 생성하여 저장 후 반환
|
|
58
|
+
* @param key 조회할 key
|
|
59
|
+
* @param factory key가 없을 때 값을 생성하는 함수
|
|
60
|
+
* @returns 기존 값 또는 새로 생성된 값
|
|
61
61
|
*/
|
|
62
62
|
getOrCreate(key: TKey, factory: () => TValue): TValue;
|
|
63
|
-
/**
|
|
63
|
+
/** 값만 순회 (Iterator) */
|
|
64
64
|
values(): IterableIterator<TValue>;
|
|
65
|
-
/**
|
|
65
|
+
/** key만 순회 (Iterator) */
|
|
66
66
|
keys(): IterableIterator<TKey>;
|
|
67
|
-
/**
|
|
67
|
+
/** 엔트리 순회 (Iterator) */
|
|
68
68
|
entries(): IterableIterator<[TKey, TValue]>;
|
|
69
69
|
private _startGc;
|
|
70
70
|
private _runGc;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lazy-gc-map.d.ts","sourceRoot":"","sources":["../../src/types/lazy-gc-map.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS,CAAC,IAAI,EAAE,MAAM;IAoB/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAG/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0D;IAG/E,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAElD,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;OAKG;gBAEgB,QAAQ,EAAE;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D;IAGH,
|
|
1
|
+
{"version":3,"file":"lazy-gc-map.d.ts","sourceRoot":"","sources":["../../src/types/lazy-gc-map.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS,CAAC,IAAI,EAAE,MAAM;IAoB/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAgC;IAG/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0D;IAG/E,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAElD,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;OAKG;gBAEgB,QAAQ,EAAE;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D;IAGH,eAAe;IACf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mCAAmC;IACnC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAKvB,sBAAsB;IACtB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAUlC,kCAAkC;IAClC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOnC,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAU1B,mCAAmC;IACnC,OAAO,IAAI,IAAI;IAOf,mBAAmB;IACnB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM;IAerD,uBAAuB;IACtB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAOnC,yBAAyB;IACxB,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC;IAK/B,wBAAwB;IACvB,OAAO,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAS5C,OAAO,CAAC,QAAQ;YAUF,MAAM;IAmDpB,OAAO,CAAC,OAAO;CAQhB"}
|
|
@@ -1,165 +1,208 @@
|
|
|
1
1
|
import consola from "consola";
|
|
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
|
-
getOrCreate(key, factory) {
|
|
79
|
-
if (this._isDestroyed) {
|
|
80
|
-
throw new Error("LazyGcMap has already been disposed.");
|
|
81
|
-
}
|
|
82
|
-
const item = this._map.get(key);
|
|
83
|
-
if (item == null) {
|
|
84
|
-
const value = factory();
|
|
85
|
-
this.set(key, value);
|
|
86
|
-
return value;
|
|
87
|
-
}
|
|
88
|
-
item.lastAccess = Date.now();
|
|
89
|
-
return item.value;
|
|
90
|
-
}
|
|
91
|
-
/** Iterate over values only (Iterator) */
|
|
92
|
-
*values() {
|
|
93
|
-
if (this._isDestroyed) return;
|
|
94
|
-
for (const item of this._map.values()) {
|
|
95
|
-
yield item.value;
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
/** Iterate over keys only (Iterator) */
|
|
99
|
-
*keys() {
|
|
100
|
-
if (this._isDestroyed) return;
|
|
101
|
-
yield* this._map.keys();
|
|
102
|
-
}
|
|
103
|
-
/** Iterate over entries (Iterator) */
|
|
104
|
-
*entries() {
|
|
105
|
-
if (this._isDestroyed) return;
|
|
106
|
-
for (const [key, item] of this._map.entries()) {
|
|
107
|
-
yield [key, item.value];
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
//#region GC logic
|
|
111
|
-
_startGc() {
|
|
112
|
-
if (this._isDestroyed) return;
|
|
113
|
-
if (this._gcTimer != null) return;
|
|
114
|
-
const interval = this._options.gcInterval ?? Math.max(this._options.expireTime / 10, 1e3);
|
|
115
|
-
this._gcTimer = setInterval(() => {
|
|
116
|
-
void this._runGc();
|
|
117
|
-
}, interval);
|
|
118
|
-
}
|
|
119
|
-
async _runGc() {
|
|
120
|
-
if (this._isGcRunning) return;
|
|
121
|
-
this._isGcRunning = true;
|
|
122
|
-
try {
|
|
123
|
-
const now = Date.now();
|
|
124
|
-
const expiredEntries = [];
|
|
125
|
-
for (const [key, item] of this._map) {
|
|
126
|
-
if (now - item.lastAccess > this._options.expireTime) {
|
|
127
|
-
expiredEntries.push({ key, item });
|
|
2
|
+
/**
|
|
3
|
+
* 자동 만료 기능이 있는 Map
|
|
4
|
+
* LRU 방식으로 접근 시간을 갱신하고, 지정된 시간 동안 접근하지 않으면 자동 삭제
|
|
5
|
+
*
|
|
6
|
+
* @note 사용 후 반드시 dispose()를 호출하거나 'using' 문을 사용해야 함.
|
|
7
|
+
* 그렇지 않으면 GC 타이머가 계속 실행되어 메모리 누수 발생.
|
|
8
|
+
*
|
|
9
|
+
* @example
|
|
10
|
+
* // using 문 (권장)
|
|
11
|
+
* using map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 });
|
|
12
|
+
*
|
|
13
|
+
* // 또는 명시적 dispose() 호출
|
|
14
|
+
* const map = new LazyGcMap({ gcInterval: 10000, expireTime: 60000 });
|
|
15
|
+
* try {
|
|
16
|
+
* // ... 사용
|
|
17
|
+
* } finally {
|
|
18
|
+
* map.dispose();
|
|
19
|
+
* }
|
|
20
|
+
*/
|
|
21
|
+
export class LazyGcMap {
|
|
22
|
+
_options;
|
|
23
|
+
static _logger = consola.withTag("LazyGcMap");
|
|
24
|
+
// 실제 데이터와 마지막 접근 시간을 함께 저장
|
|
25
|
+
_map = new Map();
|
|
26
|
+
// GC 타이머
|
|
27
|
+
_gcTimer;
|
|
28
|
+
// 중복 GC 실행 방지 플래그
|
|
29
|
+
_isGcRunning = false;
|
|
30
|
+
// dispose()가 호출되었는지 여부
|
|
31
|
+
_isDestroyed = false;
|
|
32
|
+
/**
|
|
33
|
+
* @param _options 설정 옵션
|
|
34
|
+
* @param _options.gcInterval GC 간격 (밀리초). 기본값: expireTime의 1/10 (최소 1000ms)
|
|
35
|
+
* @param _options.expireTime 만료 시간 (밀리초). 마지막 접근 이후 이 시간이 지나면 삭제됨. 예: 60000 (60초)
|
|
36
|
+
* @param _options.onExpire 만료 시 호출되는 콜백. 비동기 함수 가능, 에러 발생 시 로그 출력 후 계속 실행
|
|
37
|
+
*/
|
|
38
|
+
constructor(_options) {
|
|
39
|
+
this._options = _options;
|
|
40
|
+
}
|
|
41
|
+
/** 저장된 항목 수 */
|
|
42
|
+
get size() {
|
|
43
|
+
return this._map.size;
|
|
44
|
+
}
|
|
45
|
+
/** key 존재 여부 확인 (접근 시간 갱신하지 않음) */
|
|
46
|
+
has(key) {
|
|
47
|
+
if (this._isDestroyed)
|
|
48
|
+
return false;
|
|
49
|
+
return this._map.has(key);
|
|
50
|
+
}
|
|
51
|
+
/** 값 조회 (접근 시간 갱신) */
|
|
52
|
+
get(key) {
|
|
53
|
+
if (this._isDestroyed)
|
|
54
|
+
return undefined;
|
|
55
|
+
const item = this._map.get(key);
|
|
56
|
+
if (item == null)
|
|
57
|
+
return undefined;
|
|
58
|
+
// 조회 시 접근 시간 갱신 (LRU)
|
|
59
|
+
item.lastAccess = Date.now();
|
|
60
|
+
return item.value;
|
|
61
|
+
}
|
|
62
|
+
/** 값 저장 (접근 시간 설정 및 GC 타이머 시작) */
|
|
63
|
+
set(key, value) {
|
|
64
|
+
if (this._isDestroyed)
|
|
65
|
+
return;
|
|
66
|
+
this._map.set(key, { value, lastAccess: Date.now() });
|
|
67
|
+
// 데이터 추가 시 GC 타이머 시작
|
|
68
|
+
this._startGc();
|
|
69
|
+
}
|
|
70
|
+
/** 항목 삭제 (비어있으면 GC 타이머 중지) */
|
|
71
|
+
delete(key) {
|
|
72
|
+
if (this._isDestroyed)
|
|
73
|
+
return false;
|
|
74
|
+
const result = this._map.delete(key);
|
|
75
|
+
// 비어있으면 타이머 중지
|
|
76
|
+
if (this._map.size === 0) {
|
|
77
|
+
this._stopGc();
|
|
128
78
|
}
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
79
|
+
return result;
|
|
80
|
+
}
|
|
81
|
+
/** 인스턴스 정리 (GC 타이머 중지 및 데이터 삭제) */
|
|
82
|
+
dispose() {
|
|
83
|
+
if (this._isDestroyed)
|
|
84
|
+
return;
|
|
85
|
+
this._isDestroyed = true;
|
|
86
|
+
this._map.clear();
|
|
87
|
+
this._stopGc();
|
|
88
|
+
}
|
|
89
|
+
/** 'using' 문 지원 */
|
|
90
|
+
[Symbol.dispose]() {
|
|
91
|
+
this.dispose();
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* 모든 항목 삭제 (인스턴스는 계속 사용 가능)
|
|
95
|
+
*/
|
|
96
|
+
clear() {
|
|
97
|
+
if (this._isDestroyed)
|
|
98
|
+
return;
|
|
99
|
+
this._map.clear();
|
|
100
|
+
this._stopGc();
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* key에 대한 값을 반환하거나, 없으면 팩토리로 생성하여 저장 후 반환
|
|
104
|
+
* @param key 조회할 key
|
|
105
|
+
* @param factory key가 없을 때 값을 생성하는 함수
|
|
106
|
+
* @returns 기존 값 또는 새로 생성된 값
|
|
107
|
+
*/
|
|
108
|
+
getOrCreate(key, factory) {
|
|
109
|
+
if (this._isDestroyed) {
|
|
110
|
+
throw new Error("LazyGcMap이 이미 dispose되었습니다.");
|
|
134
111
|
}
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
}
|
|
112
|
+
const item = this._map.get(key);
|
|
113
|
+
if (item == null) {
|
|
114
|
+
const value = factory();
|
|
115
|
+
this.set(key, value);
|
|
116
|
+
return value;
|
|
141
117
|
}
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
118
|
+
item.lastAccess = Date.now();
|
|
119
|
+
return item.value;
|
|
120
|
+
}
|
|
121
|
+
/** 값만 순회 (Iterator) */
|
|
122
|
+
*values() {
|
|
123
|
+
if (this._isDestroyed)
|
|
124
|
+
return;
|
|
125
|
+
for (const item of this._map.values()) {
|
|
126
|
+
yield item.value;
|
|
145
127
|
}
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
128
|
+
}
|
|
129
|
+
/** key만 순회 (Iterator) */
|
|
130
|
+
*keys() {
|
|
131
|
+
if (this._isDestroyed)
|
|
132
|
+
return;
|
|
133
|
+
yield* this._map.keys();
|
|
134
|
+
}
|
|
135
|
+
/** 엔트리 순회 (Iterator) */
|
|
136
|
+
*entries() {
|
|
137
|
+
if (this._isDestroyed)
|
|
138
|
+
return;
|
|
139
|
+
for (const [key, item] of this._map.entries()) {
|
|
140
|
+
yield [key, item.value];
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
//#region GC logic
|
|
144
|
+
_startGc() {
|
|
145
|
+
if (this._isDestroyed)
|
|
146
|
+
return;
|
|
147
|
+
if (this._gcTimer != null)
|
|
148
|
+
return;
|
|
149
|
+
const interval = this._options.gcInterval ?? Math.max(this._options.expireTime / 10, 1000);
|
|
150
|
+
this._gcTimer = setInterval(() => {
|
|
151
|
+
void this._runGc();
|
|
152
|
+
}, interval);
|
|
153
|
+
}
|
|
154
|
+
async _runGc() {
|
|
155
|
+
// 이미 실행 중이면 건너뜀 (onExpire 콜백이 오래 걸릴 때 중복 실행 방지)
|
|
156
|
+
if (this._isGcRunning)
|
|
157
|
+
return;
|
|
158
|
+
this._isGcRunning = true;
|
|
159
|
+
try {
|
|
160
|
+
const now = Date.now();
|
|
161
|
+
// 1. 만료된 항목 수집 (삭제 전)
|
|
162
|
+
const expiredEntries = [];
|
|
163
|
+
for (const [key, item] of this._map) {
|
|
164
|
+
if (now - item.lastAccess > this._options.expireTime) {
|
|
165
|
+
expiredEntries.push({ key, item });
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
// 2. 각 항목에 대해 콜백 실행 후 삭제
|
|
169
|
+
for (const { key, item } of expiredEntries) {
|
|
170
|
+
// 콜백 전 현재 상태 확인 (이미 교체되었거나 삭제된 경우 건너뜀)
|
|
171
|
+
const currentItem = this._map.get(key);
|
|
172
|
+
if (currentItem !== item) {
|
|
173
|
+
continue;
|
|
174
|
+
}
|
|
175
|
+
// 만료 콜백 실행
|
|
176
|
+
if (this._options.onExpire != null) {
|
|
177
|
+
try {
|
|
178
|
+
await this._options.onExpire(key, item.value);
|
|
179
|
+
}
|
|
180
|
+
catch (err) {
|
|
181
|
+
LazyGcMap._logger.error("onExpire 콜백 오류", err);
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
// 콜백 후 항목이 다시 등록되었는지 확인
|
|
185
|
+
// 시나리오: onExpire 콜백이 같은 key로 set()을 호출하면,
|
|
186
|
+
// 새로 등록된 항목을 삭제하면 안 됨. 항목 참조가 같으면 재등록되지 않은 것이므로 삭제.
|
|
187
|
+
const afterItem = this._map.get(key);
|
|
188
|
+
if (afterItem === item) {
|
|
189
|
+
this._map.delete(key);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
// 정리 후 비어있으면 GC 중지
|
|
193
|
+
if (this._map.size === 0) {
|
|
194
|
+
this._stopGc();
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
finally {
|
|
198
|
+
this._isGcRunning = false;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
_stopGc() {
|
|
202
|
+
if (this._gcTimer != null) {
|
|
203
|
+
clearInterval(this._gcTimer);
|
|
204
|
+
this._gcTimer = undefined;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
161
207
|
}
|
|
162
|
-
|
|
163
|
-
LazyGcMap
|
|
164
|
-
};
|
|
165
|
-
//# sourceMappingURL=lazy-gc-map.js.map
|
|
208
|
+
//# sourceMappingURL=lazy-gc-map.js.map
|
|
@@ -1,6 +1 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 3,
|
|
3
|
-
"sources": ["../../src/types/lazy-gc-map.ts"],
|
|
4
|
-
"mappings": "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",
|
|
5
|
-
"names": []
|
|
6
|
-
}
|
|
1
|
+
{"version":3,"file":"lazy-gc-map.js","sourceRoot":"","sources":["../../src/types/lazy-gc-map.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,SAAS;IAoBD;IAnBX,MAAM,CAAU,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/D,2BAA2B;IACV,IAAI,GAAG,IAAI,GAAG,EAA+C,CAAC;IAE/E,SAAS;IACD,QAAQ,CAAkC;IAClD,kBAAkB;IACV,YAAY,GAAG,KAAK,CAAC;IAC7B,uBAAuB;IACf,YAAY,GAAG,KAAK,CAAC;IAE7B;;;;;OAKG;IACH,YACmB,QAIhB;QAJgB,aAAQ,GAAR,QAAQ,CAIxB;IACA,CAAC;IAEJ,eAAe;IACf,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,mCAAmC;IACnC,GAAG,CAAC,GAAS;QACX,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,sBAAsB;IACtB,GAAG,CAAC,GAAS;QACX,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,SAAS,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC;QAEnC,sBAAsB;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,kCAAkC;IAClC,GAAG,CAAC,GAAS,EAAE,KAAa;QAC1B,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACtD,qBAAqB;QACrB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,8BAA8B;IAC9B,MAAM,CAAC,GAAS;QACd,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,eAAe;QACf,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mCAAmC;IACnC,OAAO;QACL,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,mBAAmB;IACnB,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAAS,EAAE,OAAqB;QAC1C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,uBAAuB;IACvB,CAAC,MAAM;QACL,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,CAAC,IAAI;QACH,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,wBAAwB;IACxB,CAAC,OAAO;QACN,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,kBAAkB;IAEV,QAAQ;QACd,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI;YAAE,OAAO;QAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3F,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;YAC/B,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC,EAAE,QAAQ,CAAC,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,gDAAgD;QAChD,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEvB,sBAAsB;YACtB,MAAM,cAAc,GAAiE,EAAE,CAAC;YACxF,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACrD,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,cAAc,EAAE,CAAC;gBAC3C,uCAAuC;gBACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;oBACzB,SAAS;gBACX,CAAC;gBAED,WAAW;gBACX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;oBACnC,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;oBAChD,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;oBACjD,CAAC;gBACH,CAAC;gBAED,wBAAwB;gBACxB,0CAA0C;gBAC1C,oDAAoD;gBACpD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,mBAAmB;YACnB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC"}
|
package/dist/types/time.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* 시간 클래스 (날짜 제외: HH:mm:ss.fff, 불변)
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
4
|
+
* 날짜 정보 없이 시간만 저장하는 불변 클래스.
|
|
5
|
+
* 24시간을 초과하거나 음수인 값은 자동으로 정규화됨.
|
|
6
6
|
*
|
|
7
7
|
* @example
|
|
8
8
|
* const now = new Time();
|
|
@@ -12,20 +12,20 @@
|
|
|
12
12
|
export declare class Time {
|
|
13
13
|
private static readonly MS_PER_DAY;
|
|
14
14
|
private readonly _tick;
|
|
15
|
-
/**
|
|
15
|
+
/** 현재 시간으로 생성 */
|
|
16
16
|
constructor();
|
|
17
|
-
/**
|
|
17
|
+
/** 시, 분, 초, 밀리초로 생성 */
|
|
18
18
|
constructor(hour: number, minute: number, second?: number, millisecond?: number);
|
|
19
|
-
/**
|
|
19
|
+
/** tick (밀리초)으로 생성 */
|
|
20
20
|
constructor(tick: number);
|
|
21
|
-
/**
|
|
21
|
+
/** Date 객체에서 시간 부분만 추출하여 생성 */
|
|
22
22
|
constructor(date: Date);
|
|
23
23
|
/**
|
|
24
|
-
*
|
|
24
|
+
* 문자열을 파싱하여 Time 인스턴스 생성
|
|
25
25
|
*
|
|
26
|
-
* @param str
|
|
27
|
-
* @returns
|
|
28
|
-
* @throws ArgumentError
|
|
26
|
+
* @param str 시간 문자열
|
|
27
|
+
* @returns 파싱된 Time 인스턴스
|
|
28
|
+
* @throws ArgumentError 지원하지 않는 형식인 경우
|
|
29
29
|
*
|
|
30
30
|
* @example
|
|
31
31
|
* Time.parse("10:30:00") // HH:mm:ss
|
|
@@ -39,28 +39,28 @@ export declare class Time {
|
|
|
39
39
|
get second(): number;
|
|
40
40
|
get millisecond(): number;
|
|
41
41
|
get tick(): number;
|
|
42
|
-
/**
|
|
42
|
+
/** 시간이 올바르게 설정되었는지 여부 */
|
|
43
43
|
get isValid(): boolean;
|
|
44
|
-
/**
|
|
44
|
+
/** 지정된 시로 새 인스턴스 반환 */
|
|
45
45
|
setHour(hour: number): Time;
|
|
46
|
-
/**
|
|
46
|
+
/** 지정된 분으로 새 인스턴스 반환 */
|
|
47
47
|
setMinute(minute: number): Time;
|
|
48
|
-
/**
|
|
48
|
+
/** 지정된 초로 새 인스턴스 반환 */
|
|
49
49
|
setSecond(second: number): Time;
|
|
50
|
-
/**
|
|
50
|
+
/** 지정된 밀리초로 새 인스턴스 반환 */
|
|
51
51
|
setMillisecond(millisecond: number): Time;
|
|
52
|
-
/**
|
|
52
|
+
/** 지정된 시간을 더한 새 인스턴스 반환 (24시간 순환) */
|
|
53
53
|
addHours(hours: number): Time;
|
|
54
|
-
/**
|
|
54
|
+
/** 지정된 분을 더한 새 인스턴스 반환 (24시간 순환) */
|
|
55
55
|
addMinutes(minutes: number): Time;
|
|
56
|
-
/**
|
|
56
|
+
/** 지정된 초를 더한 새 인스턴스 반환 (24시간 순환) */
|
|
57
57
|
addSeconds(seconds: number): Time;
|
|
58
|
-
/**
|
|
58
|
+
/** 지정된 밀리초를 더한 새 인스턴스 반환 (24시간 순환) */
|
|
59
59
|
addMilliseconds(milliseconds: number): Time;
|
|
60
60
|
/**
|
|
61
|
-
*
|
|
62
|
-
* @param format
|
|
63
|
-
* @see dtFormat
|
|
61
|
+
* 지정된 형식으로 문자열 변환
|
|
62
|
+
* @param format 형식 문자열
|
|
63
|
+
* @see dtFormat 지원되는 형식 문자열 참조
|
|
64
64
|
*/
|
|
65
65
|
toFormatString(formatStr: string): string;
|
|
66
66
|
toString(): string;
|
package/dist/types/time.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/types/time.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B
|
|
1
|
+
{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/types/time.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,iBAAiB;;IAEjB,uBAAuB;gBACX,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAC/E,sBAAsB;gBACV,IAAI,EAAE,MAAM;IACxB,+BAA+B;gBACnB,IAAI,EAAE,IAAI;IA8BtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA+C/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yBAAyB;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD,uBAAuB;IACvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,wBAAwB;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,uBAAuB;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,yBAAyB;IACzB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQzC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,oCAAoC;IACpC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,oCAAoC;IACpC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,sCAAsC;IACtC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAU3C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IASzC,QAAQ,IAAI,MAAM;CAKnB"}
|