@zwa73/utils 1.0.57 → 1.0.61

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.
Files changed (42) hide show
  1. package/dist/UtilCodecs.d.ts +16 -16
  2. package/dist/UtilCodecs.js +16 -16
  3. package/dist/UtilCom.d.ts +22 -25
  4. package/dist/UtilCom.js +35 -38
  5. package/dist/UtilDecorators.d.ts +15 -8
  6. package/dist/UtilDecorators.js +79 -25
  7. package/dist/UtilFP.d.ts +46 -0
  8. package/dist/UtilFP.js +52 -0
  9. package/dist/UtilFfmpegTools.d.ts +30 -30
  10. package/dist/UtilFfmpegTools.js +32 -32
  11. package/dist/UtilFileTools.d.ts +30 -35
  12. package/dist/UtilFileTools.js +17 -18
  13. package/dist/UtilFunctions.d.ts +37 -78
  14. package/dist/UtilFunctions.js +27 -62
  15. package/dist/UtilInterfaces.d.ts +11 -11
  16. package/dist/UtilInterfaces.js +2 -2
  17. package/dist/UtilLogger.d.ts +55 -55
  18. package/dist/UtilLogger.js +55 -55
  19. package/dist/index.d.ts +1 -0
  20. package/dist/index.js +1 -0
  21. package/dist/test/composeTest.d.ts +21 -0
  22. package/dist/test/composeTest.js +33 -0
  23. package/dist/test/importtest.d.ts +1 -0
  24. package/dist/test/importtest.js +4 -0
  25. package/dist/test/test.js +5 -3
  26. package/package.json +2 -2
  27. package/src/UtilClass.ts +1051 -1051
  28. package/src/UtilCodecs.ts +117 -117
  29. package/src/UtilCom.ts +171 -174
  30. package/src/UtilDecorators.ts +174 -116
  31. package/src/UtilFP.ts +98 -0
  32. package/src/UtilFfmpegTools.ts +271 -271
  33. package/src/UtilFileTools.ts +231 -236
  34. package/src/UtilFunctions.ts +289 -364
  35. package/src/UtilInterfaces.ts +137 -137
  36. package/src/UtilLogger.ts +386 -386
  37. package/src/index.ts +10 -9
  38. package/src/test/composeTest.ts +37 -0
  39. package/src/test/importtest.ts +5 -0
  40. package/src/test/test.ts +8 -6
  41. package/src/test/test2.ts +2 -3
  42. package/tsconfig.json +2 -7
@@ -8,19 +8,18 @@ const UtilLogger_1 = require("./UtilLogger");
8
8
  var UtilFunc;
9
9
  (function (UtilFunc) {
10
10
  /**获取当前时间戳
11
- * number ()
12
- * @returns {number} 时间戳
11
+ * @returns 时间戳
13
12
  */
14
13
  function getTime() {
15
14
  return new Date().getTime();
16
15
  }
17
16
  UtilFunc.getTime = getTime;
18
17
  /**初始化对象的字段
19
- * void (Object,string,any)
20
- * @param {Record<string,T>} obj - 所要初始化的对象
21
- * @param {string} field - 所要初始化的字段
22
- * @param {T} defaultVal - 默认值
23
- * @returns {T} - 最终值
18
+ * 会改变obj
19
+ * @param obj - 所要初始化的对象
20
+ * @param field - 所要初始化的字段
21
+ * @param defaultVal - 默认值
22
+ * @returns 最终值
24
23
  */
25
24
  function initField(obj, field, defaultVal) {
26
25
  if (!(field in obj))
@@ -29,34 +28,32 @@ var UtilFunc;
29
28
  }
30
29
  UtilFunc.initField = initField;
31
30
  /**生成一串uuid
32
- * string ()
33
- * @returns {string} uuid
31
+ * @returns uuid
34
32
  */
35
33
  function genUUID() {
36
34
  return crypto.randomBytes(16).toString("hex");
37
35
  }
38
36
  UtilFunc.genUUID = genUUID;
39
37
  /**计算Hash
40
- * string ()
41
- * @param {string} str - 待计算的字符串
42
- * @returns {string} hash
38
+ * @param str - 待计算的字符串
39
+ * @returns hash
43
40
  */
44
41
  function calcHash(str) {
45
42
  return crypto.createHash('md5').update(str).digest('hex');
46
43
  }
47
44
  UtilFunc.calcHash = calcHash;
48
45
  /**深克隆 序列化并反序列化
49
- * @template {T} T - JToken类型的泛型
50
- * @param {T} obj - 克隆目标
51
- * @returns {T} 克隆结果
46
+ * @template T - JToken类型的泛型
47
+ * @param obj - 克隆目标
48
+ * @returns 克隆结果
52
49
  */
53
50
  function deepClone(obj) {
54
51
  return JSON.parse(JSON.stringify(obj));
55
52
  }
56
53
  UtilFunc.deepClone = deepClone;
57
54
  /**是否为安全的数字
58
- * @param {number} num - 所要检测的数字
59
- * @returns {boolean} 是否安全
55
+ * @param num - 所要检测的数字
56
+ * @returns 是否安全
60
57
  */
61
58
  function isSafeNumber(num) {
62
59
  if (num === undefined || num == null || isNaN(num))
@@ -68,8 +65,8 @@ var UtilFunc;
68
65
  UtilFunc.isSafeNumber = isSafeNumber;
69
66
  /**等待 timeMs 毫秒
70
67
  * @async
71
- * @param {number} timeMs - 等待的毫秒数
72
- * @returns {Promise<boolean>}
68
+ * @param timeMs - 等待的毫秒数
69
+ * @returns
73
70
  */
74
71
  async function sleep(timeMs) {
75
72
  return new Promise(function (resolve, rejecte) {
@@ -80,7 +77,7 @@ var UtilFunc;
80
77
  }
81
78
  UtilFunc.sleep = sleep;
82
79
  /**封装的 cp.exec 执行一段指令 指令完成后返回 Promise
83
- * @param {string} command 指令文本
80
+ * @param command 指令文本
84
81
  */
85
82
  function exec(command) {
86
83
  return new Promise((resolve, reject) => {
@@ -102,11 +99,11 @@ var UtilFunc;
102
99
  UtilFunc.getNeverResolvedPromise = getNeverResolvedPromise;
103
100
  /**重复尝试promise
104
101
  * @async
105
- * @param {PromiseProcFn<T>} [procFn] - 发起函数
106
- * @param {PromiseVerifyFn<T>} [verifyFn] - 验证函数
107
- * @param {number} [repeatCount] - 重试次数
108
- * @param {number} [repeatTime] - 超时时间/秒 最小为10秒
109
- * @returns {Promise<T|null>} - 结果 null 为全部失败/超时
102
+ * @param procFn - 发起函数
103
+ * @param verifyFn - 验证函数
104
+ * @param repeatCount - 重试次数
105
+ * @param repeatTime - 超时时间/秒 最小为10秒
106
+ * @returns - 结果 null 为全部失败/超时
110
107
  */
111
108
  async function repeatPromise(procFn, verifyFn, repeatCount = 3, repeatTime = 180) {
112
109
  //计时
@@ -200,46 +197,14 @@ var UtilFunc;
200
197
  }
201
198
  }
202
199
  UtilFunc.repeatPromise = repeatPromise;
203
- /**柯里化转换
204
- * @param {T} fn - 将要转换的函数
205
- * @returns {CurryFunc<T>} 柯里化的函数
206
- */
207
- function curry(fn) {
208
- return (function curried(...args) {
209
- if (args.length >= fn.length)
210
- return fn(...args);
211
- return (...restArgs) => curried(...args, ...restArgs);
212
- });
213
- }
214
- UtilFunc.curry = curry;
215
- /**函数组合
216
- * 从右到左执行
217
- * @param {Function[]} funcs - 待组合的函数
218
- * @returns {(arg: any)=>any} 组合完成的函数
219
- */
220
- function compose(...funcs) {
221
- return (arg) => funcs.reduceRight((value, func) => func(value), arg);
222
- }
223
- UtilFunc.compose = compose;
224
- /**函数管道
225
- * 从左到右执行
226
- * @param {((arg: T) => T)} funcs - 待组合的函数
227
- * @returns {((arg: T) => T)} 组合完成的函数
228
- */
229
- function pipeline(...funcs) {
230
- return (arg) => {
231
- return funcs.reduce((value, func) => func(value), arg);
232
- };
233
- }
234
- UtilFunc.pipeline = pipeline;
235
200
  /**部分类组合
236
201
  * 将mixin的部分字段混入base
237
202
  * @param base - 基础类
238
203
  * @param mixin - 目标类
239
204
  * @param fields - 需要混入的字段
240
- * @returns - 混合完成的类
205
+ * @returns 混合完成的类
241
206
  */
242
- function composePartClass(base, mixin, ...fields) {
207
+ function composeClassPart(base, mixin, ...fields) {
243
208
  const compObj = base;
244
209
  for (const fd of fields) {
245
210
  Object.defineProperty(compObj, fd, {
@@ -253,7 +218,7 @@ var UtilFunc;
253
218
  }
254
219
  return compObj;
255
220
  }
256
- UtilFunc.composePartClass = composePartClass;
221
+ UtilFunc.composeClassPart = composeClassPart;
257
222
  /**类组合
258
223
  * 将mixinList每个成员的字段混入base
259
224
  * @param base - 基础类
@@ -296,11 +261,11 @@ var UtilFunc;
296
261
  * @param mapper - 映射函数,接受一个值和一个键,返回一个新的值
297
262
  * @returns - 一个新的对象,它的属性是原对象的属性经过映射函数处理后的结果
298
263
  */
299
- function mapObject(obj, mapper) {
264
+ function mapEntries(obj, mapper) {
300
265
  return Object.entries(obj).reduce((result, [key, value]) => {
301
266
  result[key] = mapper(key, value);
302
267
  return result;
303
268
  }, {});
304
269
  }
305
- UtilFunc.mapObject = mapObject;
270
+ UtilFunc.mapEntries = mapEntries;
306
271
  })(UtilFunc = exports.UtilFunc || (exports.UtilFunc = {}));
@@ -15,8 +15,8 @@ export interface IJData {
15
15
  toJSON(): JToken;
16
16
  }
17
17
  /**将JToken转换为字符串
18
- * @param {JToken|IJData} token - 待转换的Token
19
- * @param {string|number|null} space - 插入的空格 数字为空格数量 默认为制表符\t
18
+ * @param token - 待转换的Token
19
+ * @param space - 插入的空格 数字为空格数量 默认为制表符\t
20
20
  * @returns 转换完成的字符串
21
21
  */
22
22
  export declare function stringifyJToken(token: JToken | IJData, space?: string | number | null | undefined): string;
@@ -68,21 +68,21 @@ export type FuncPropNames<T> = {
68
68
  [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
69
69
  }[keyof T];
70
70
  /**部分组合的类
71
- * @template {Base} - 基类
72
- * @template {Mixin} - 待混入的类
73
- * @template {PropKeys} - 需要混入的成员key
71
+ * @template Base - 基类
72
+ * @template Mixin - 待混入的类
73
+ * @template PropKeys - 需要混入的成员key
74
74
  */
75
- export type ComposedPartClass<Base extends object, Mixin extends object, PropKeys extends keyof Mixin> = Base & Pick<Mixin, PropKeys>;
75
+ export type ComposedClassPart<Base extends object, Mixin extends object, PropKeys extends keyof Mixin> = Base & Pick<Mixin, PropKeys>;
76
76
  /**组合的类 嵌套变体 */
77
- export type ComposedPartClassMult<Base extends object, Mixin1 extends object = {}, PropKeys1 extends keyof Mixin1 = keyof Mixin1, Mixin2 extends object = {}, PropKeys2 extends keyof Mixin2 = keyof Mixin2, Mixin3 extends object = {}, PropKeys3 extends keyof Mixin3 = keyof Mixin3, Mixin4 extends object = {}, PropKeys4 extends keyof Mixin4 = keyof Mixin4, Mixin5 extends object = {}, PropKeys5 extends keyof Mixin5 = keyof Mixin5, Mixin6 extends object = {}, PropKeys6 extends keyof Mixin6 = keyof Mixin6> = ComposedPartClass<ComposedPartClass<ComposedPartClass<ComposedPartClass<ComposedPartClass<ComposedPartClass<Base, Mixin1, PropKeys1>, Mixin2, PropKeys2>, Mixin3, PropKeys3>, Mixin4, PropKeys4>, Mixin5, PropKeys5>, Mixin6, PropKeys6>;
77
+ export type ComposedPartClassMult<Base extends object, Mixin1 extends object = {}, PropKeys1 extends keyof Mixin1 = keyof Mixin1, Mixin2 extends object = {}, PropKeys2 extends keyof Mixin2 = keyof Mixin2, Mixin3 extends object = {}, PropKeys3 extends keyof Mixin3 = keyof Mixin3, Mixin4 extends object = {}, PropKeys4 extends keyof Mixin4 = keyof Mixin4, Mixin5 extends object = {}, PropKeys5 extends keyof Mixin5 = keyof Mixin5, Mixin6 extends object = {}, PropKeys6 extends keyof Mixin6 = keyof Mixin6> = ComposedClassPart<ComposedClassPart<ComposedClassPart<ComposedClassPart<ComposedClassPart<ComposedClassPart<Base, Mixin1, PropKeys1>, Mixin2, PropKeys2>, Mixin3, PropKeys3>, Mixin4, PropKeys4>, Mixin5, PropKeys5>, Mixin6, PropKeys6>;
78
78
  /**组合的类
79
- * @template {Base} - 基类
80
- * @template {Mixin} - 待混入的类
79
+ * @template Base - 基类
80
+ * @template Mixin - 待混入的类
81
81
  */
82
82
  export type ComposedClass<Base extends object, Mixin extends object> = Base & Mixin;
83
83
  /**组合的类 多组合变体
84
- * @template {Base} - 基类
85
- * @template {MixinList}- 待混入的类型数组
84
+ * @template Base - 基类
85
+ * @template MixinList- 待混入的类型数组
86
86
  */
87
87
  export type ComposedClassMult<Base extends object, MixinList extends object[]> = MixinList extends [infer Mixin, ...infer Rest] ? Mixin extends object ? Rest extends object[] ? ComposedClassMult<ComposedClass<Base, Mixin>, Rest> : Base : Base : Base;
88
88
  export {};
@@ -2,8 +2,8 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.stringifyJToken = void 0;
4
4
  /**将JToken转换为字符串
5
- * @param {JToken|IJData} token - 待转换的Token
6
- * @param {string|number|null} space - 插入的空格 数字为空格数量 默认为制表符\t
5
+ * @param token - 待转换的Token
6
+ * @param space - 插入的空格 数字为空格数量 默认为制表符\t
7
7
  * @returns 转换完成的字符串
8
8
  */
9
9
  function stringifyJToken(token, space = "\t") {
@@ -9,16 +9,16 @@ export type HRTimeLog = {
9
9
  export type LogLevel = "fatal" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
10
10
  export declare class SLogger {
11
11
  /**获取一个Logger,如不存在则用默认参数创建
12
- * @param {string} name - logger的名称 默认default
13
- * @returns {SLogger} - 获取的logger
12
+ * @param name - logger的名称 默认default
13
+ * @returns 获取的logger
14
14
  */
15
15
  static getLogger(name?: string): SLogger;
16
16
  /**创建Logger
17
- * @param {string} name - logger的名称 默认default
18
- * @param {LogLevel} consoleLevel - 输出到控制台的最低等级 默认info
19
- * @param {string} outFloder - log的输出文件夹路径 如./log/
20
- * @param {LogLevel} fileLevel - 输出到文件的最低等级 默认info
21
- * @returns {SLogger} - 创建完成的logger
17
+ * @param name - logger的名称 默认default
18
+ * @param consoleLevel - 输出到控制台的最低等级 默认info
19
+ * @param outFloder - log的输出文件夹路径 如./log/
20
+ * @param fileLevel - 输出到文件的最低等级 默认info
21
+ * @returns 创建完成的logger
22
22
  */
23
23
  static createLogger(name?: string, consoleLevel?: LogLevel, outFloder?: string, fileLevel?: LogLevel): SLogger;
24
24
  private constructor();
@@ -28,119 +28,119 @@ export declare class SLogger {
28
28
  /**记录Logger的表 */
29
29
  private static readonly timeTable;
30
30
  /**产生一条对应等级的log 返回自身
31
- * @param {LogLevel} level - log等级
32
- * @param {Array<any>} messages - log消息
33
- * @returns {SLogger} - 自身
31
+ * @param level - log等级
32
+ * @param messages - log消息
33
+ * @returns 自身
34
34
  */
35
35
  log(level: LogLevel, ...messages: Array<any>): SLogger;
36
36
  /**产生一条fatal等级的log 返回自身
37
- * @param {Array<any>} messages - log消息
38
- * @returns {SLogger} - 自身
37
+ * @param messages - log消息
38
+ * @returns 自身
39
39
  */
40
40
  fatal(...messages: Array<any>): SLogger;
41
41
  /**产生一条error等级的log 返回自身
42
- * @param {Array<any>} messages - log消息
43
- * @returns {SLogger} - 自身
42
+ * @param messages - log消息
43
+ * @returns 自身
44
44
  */
45
45
  error(...messages: Array<any>): SLogger;
46
46
  /**产生一条warn等级的log 返回自身
47
- * @param {Array<any>} messages - log消息
48
- * @returns {SLogger} - 自身
47
+ * @param messages - log消息
48
+ * @returns 自身
49
49
  */
50
50
  warn(...messages: Array<any>): SLogger;
51
51
  /**产生一条info等级的log 返回自身
52
- * @param {Array<any>} messages - log消息
53
- * @returns {SLogger} - 自身
52
+ * @param messages - log消息
53
+ * @returns 自身
54
54
  */
55
55
  info(...messages: Array<any>): SLogger;
56
56
  /**产生一条http等级的log 返回自身
57
- * @param {Array<any>} messages - log消息
58
- * @returns {SLogger} - 自身
57
+ * @param messages - log消息
58
+ * @returns 自身
59
59
  */
60
60
  http(...messages: Array<any>): SLogger;
61
61
  /**产生一条verbose等级的log 返回自身
62
- * @param {Array<any>} messages - log消息
63
- * @returns {SLogger} - 自身
62
+ * @param messages - log消息
63
+ * @returns 自身
64
64
  */
65
65
  verbose(...messages: Array<any>): SLogger;
66
66
  /**产生一条debug等级的log 返回自身
67
- * @param {Array<any>} messages - log消息
68
- * @returns {SLogger} - 自身
67
+ * @param messages - log消息
68
+ * @returns 自身
69
69
  */
70
70
  debug(...messages: Array<any>): SLogger;
71
71
  /**产生一条silly等级的log 返回自身
72
- * @param {Array<any>} messages - log消息
73
- * @returns {SLogger} - 自身
72
+ * @param messages - log消息
73
+ * @returns 自身
74
74
  */
75
75
  silly(...messages: Array<any>): SLogger;
76
76
  /**记录当前时间戳并存入表
77
- * @param {string} flag - 记录的命名
78
- * @returns {HRTimeLog} - 记录的时间
77
+ * @param flag - 记录的命名
78
+ * @returns 记录的时间
79
79
  */
80
80
  time(flag: string): HRTimeLog;
81
81
  /**根据之前记录的时间戳计算经过的时间 并输出log
82
- * @param {string} flag - 记录的命名
83
- * @param {LogLevel|null} level - log等级 ===null时不产生log
84
- * @returns {string|null} - 格式化的时间字符串
82
+ * @param flag - 记录的命名
83
+ * @param level - log等级 === null时不产生log
84
+ * @returns 格式化的时间字符串
85
85
  */
86
86
  timeEnd(flag: string, level?: LogLevel | null): string | null;
87
87
  /**名称为default的slogger实例 */
88
88
  private static get defaultInstance();
89
89
  /**让名称为default的logger 产生一条对应等级的log 返回自身
90
- * @param {LogLevel} level - log等级
91
- * @param {Array<any>} messages - log消息
92
- * @returns {SLogger} - 自身
90
+ * @param level - log等级
91
+ * @param messages - log消息
92
+ * @returns 自身
93
93
  */
94
94
  static log(level: LogLevel, ...messages: Array<any>): SLogger;
95
95
  /**让名称为default的logger 产生一条fatal等级的log 返回自身
96
- * @param {Array<any>} messages - log消息
97
- * @returns {SLogger} - 自身
96
+ * @param messages - log消息
97
+ * @returns 自身
98
98
  */
99
99
  static fatal(...messages: Array<any>): SLogger;
100
100
  /**让名称为default的logger 产生一条error等级的log 返回自身
101
- * @param {Array<any>} messages - log消息
102
- * @returns {SLogger} - 自身
101
+ * @param messages - log消息
102
+ * @returns 自身
103
103
  */
104
104
  static error(...messages: Array<any>): SLogger;
105
105
  /**让名称为default的logger 产生一条warn等级的log 返回自身
106
- * @param {Array<any>} messages - log消息
107
- * @returns {SLogger} - 自身
106
+ * @param messages - log消息
107
+ * @returns 自身
108
108
  */
109
109
  static warn(...messages: Array<any>): SLogger;
110
110
  /**让名称为default的logger 产生一条info等级的log 返回自身
111
- * @param {Array<any>} messages - log消息
112
- * @returns {SLogger} - 自身
111
+ * @param messages - log消息
112
+ * @returns 自身
113
113
  */
114
114
  static info(...messages: Array<any>): SLogger;
115
115
  /**让名称为default的logger 产生一条http等级的log 返回自身
116
- * @param {Array<any>} messages - log消息
117
- * @returns {SLogger} - 自身
116
+ * @param messages - log消息
117
+ * @returns 自身
118
118
  */
119
119
  static http(...messages: Array<any>): SLogger;
120
120
  /**让名称为default的logger 产生一条verbose等级的log 返回自身
121
- * @param {Array<any>} messages - log消息
122
- * @returns {SLogger} - 自身
121
+ * @param messages - log消息
122
+ * @returns 自身
123
123
  */
124
124
  static verbose(...messages: Array<any>): SLogger;
125
125
  /**让名称为default的logger 产生一条debug等级的log 返回自身
126
- * @param {Array<any>} messages - log消息
127
- * @returns {SLogger} - 自身
126
+ * @param messages - log消息
127
+ * @returns 自身
128
128
  */
129
129
  static debug(...messages: Array<any>): SLogger;
130
130
  /**让名称为default的logger 产生一条silly等级的log 返回自身
131
- * @param {Array<any>} messages - log消息
132
- * @returns {SLogger} - 自身
131
+ * @param messages - log消息
132
+ * @returns 自身
133
133
  */
134
134
  static silly(...messages: Array<any>): SLogger;
135
135
  /**让名称为default的logger 记录当前时间戳并存入表
136
- * @param {string} flag - 记录的命名
137
- * @returns {HRTimeLog} - 记录的时间
136
+ * @param flag - 记录的命名
137
+ * @returns 记录的时间
138
138
  */
139
139
  static time(flag: string): HRTimeLog;
140
140
  /**让名称为default的logger 根据之前记录的时间戳计算经过的时间 并输出log
141
- * @param {string} flag - 记录的命名
142
- * @param {LogLevel} level - log等级
143
- * @returns {void}
141
+ * @param flag - 记录的命名
142
+ * @param level - log等级
143
+ * @returns
144
144
  */
145
145
  static timeEnd(flag: string, level?: LogLevel): void;
146
146
  }
@@ -26,8 +26,8 @@ colorizer.addColors({
26
26
  });
27
27
  class SLogger {
28
28
  /**获取一个Logger,如不存在则用默认参数创建
29
- * @param {string} name - logger的名称 默认default
30
- * @returns {SLogger} - 获取的logger
29
+ * @param name - logger的名称 默认default
30
+ * @returns 获取的logger
31
31
  */
32
32
  static getLogger(name = "default") {
33
33
  let out = SLogger.loggerTable[name];
@@ -38,11 +38,11 @@ class SLogger {
38
38
  return out;
39
39
  }
40
40
  /**创建Logger
41
- * @param {string} name - logger的名称 默认default
42
- * @param {LogLevel} consoleLevel - 输出到控制台的最低等级 默认info
43
- * @param {string} outFloder - log的输出文件夹路径 如./log/
44
- * @param {LogLevel} fileLevel - 输出到文件的最低等级 默认info
45
- * @returns {SLogger} - 创建完成的logger
41
+ * @param name - logger的名称 默认default
42
+ * @param consoleLevel - 输出到控制台的最低等级 默认info
43
+ * @param outFloder - log的输出文件夹路径 如./log/
44
+ * @param fileLevel - 输出到文件的最低等级 默认info
45
+ * @returns 创建完成的logger
46
46
  */
47
47
  static createLogger(name = "default", consoleLevel = "info", outFloder, fileLevel = "info") {
48
48
  const transports = [];
@@ -104,9 +104,9 @@ class SLogger {
104
104
  static timeTable = {};
105
105
  //———————————————————— function ——————————————————————//
106
106
  /**产生一条对应等级的log 返回自身
107
- * @param {LogLevel} level - log等级
108
- * @param {Array<any>} messages - log消息
109
- * @returns {SLogger} - 自身
107
+ * @param level - log等级
108
+ * @param messages - log消息
109
+ * @returns 自身
110
110
  */
111
111
  log(level, ...messages) {
112
112
  level = level || "silly";
@@ -135,67 +135,67 @@ class SLogger {
135
135
  return this;
136
136
  }
137
137
  /**产生一条fatal等级的log 返回自身
138
- * @param {Array<any>} messages - log消息
139
- * @returns {SLogger} - 自身
138
+ * @param messages - log消息
139
+ * @returns 自身
140
140
  */
141
141
  fatal(...messages) {
142
142
  return this.log("fatal", ...messages);
143
143
  ;
144
144
  }
145
145
  /**产生一条error等级的log 返回自身
146
- * @param {Array<any>} messages - log消息
147
- * @returns {SLogger} - 自身
146
+ * @param messages - log消息
147
+ * @returns 自身
148
148
  */
149
149
  error(...messages) {
150
150
  return this.log("error", ...messages);
151
151
  ;
152
152
  }
153
153
  /**产生一条warn等级的log 返回自身
154
- * @param {Array<any>} messages - log消息
155
- * @returns {SLogger} - 自身
154
+ * @param messages - log消息
155
+ * @returns 自身
156
156
  */
157
157
  warn(...messages) {
158
158
  return this.log("warn", ...messages);
159
159
  ;
160
160
  }
161
161
  /**产生一条info等级的log 返回自身
162
- * @param {Array<any>} messages - log消息
163
- * @returns {SLogger} - 自身
162
+ * @param messages - log消息
163
+ * @returns 自身
164
164
  */
165
165
  info(...messages) {
166
166
  return this.log("info", ...messages);
167
167
  }
168
168
  /**产生一条http等级的log 返回自身
169
- * @param {Array<any>} messages - log消息
170
- * @returns {SLogger} - 自身
169
+ * @param messages - log消息
170
+ * @returns 自身
171
171
  */
172
172
  http(...messages) {
173
173
  return this.log("http", ...messages);
174
174
  }
175
175
  /**产生一条verbose等级的log 返回自身
176
- * @param {Array<any>} messages - log消息
177
- * @returns {SLogger} - 自身
176
+ * @param messages - log消息
177
+ * @returns 自身
178
178
  */
179
179
  verbose(...messages) {
180
180
  return this.log("verbose", ...messages);
181
181
  }
182
182
  /**产生一条debug等级的log 返回自身
183
- * @param {Array<any>} messages - log消息
184
- * @returns {SLogger} - 自身
183
+ * @param messages - log消息
184
+ * @returns 自身
185
185
  */
186
186
  debug(...messages) {
187
187
  return this.log("debug", ...messages);
188
188
  }
189
189
  /**产生一条silly等级的log 返回自身
190
- * @param {Array<any>} messages - log消息
191
- * @returns {SLogger} - 自身
190
+ * @param messages - log消息
191
+ * @returns 自身
192
192
  */
193
193
  silly(...messages) {
194
194
  return this.log("silly", ...messages);
195
195
  }
196
196
  /**记录当前时间戳并存入表
197
- * @param {string} flag - 记录的命名
198
- * @returns {HRTimeLog} - 记录的时间
197
+ * @param flag - 记录的命名
198
+ * @returns 记录的时间
199
199
  */
200
200
  time(flag) {
201
201
  let hrtime = process.hrtime();
@@ -203,9 +203,9 @@ class SLogger {
203
203
  return hrtime;
204
204
  }
205
205
  /**根据之前记录的时间戳计算经过的时间 并输出log
206
- * @param {string} flag - 记录的命名
207
- * @param {LogLevel|null} level - log等级 ===null时不产生log
208
- * @returns {string|null} - 格式化的时间字符串
206
+ * @param flag - 记录的命名
207
+ * @param level - log等级 === null时不产生log
208
+ * @returns 格式化的时间字符串
209
209
  */
210
210
  timeEnd(flag, level = "info") {
211
211
  let start = SLogger.timeTable[flag];
@@ -273,9 +273,9 @@ class SLogger {
273
273
  return SLogger.loggerTable.default;
274
274
  }
275
275
  /**让名称为default的logger 产生一条对应等级的log 返回自身
276
- * @param {LogLevel} level - log等级
277
- * @param {Array<any>} messages - log消息
278
- * @returns {SLogger} - 自身
276
+ * @param level - log等级
277
+ * @param messages - log消息
278
+ * @returns 自身
279
279
  */
280
280
  static log(level, ...messages) {
281
281
  level = level || "silly";
@@ -283,75 +283,75 @@ class SLogger {
283
283
  return this.defaultInstance;
284
284
  }
285
285
  /**让名称为default的logger 产生一条fatal等级的log 返回自身
286
- * @param {Array<any>} messages - log消息
287
- * @returns {SLogger} - 自身
286
+ * @param messages - log消息
287
+ * @returns 自身
288
288
  */
289
289
  static fatal(...messages) {
290
290
  return this.log("fatal", ...messages);
291
291
  ;
292
292
  }
293
293
  /**让名称为default的logger 产生一条error等级的log 返回自身
294
- * @param {Array<any>} messages - log消息
295
- * @returns {SLogger} - 自身
294
+ * @param messages - log消息
295
+ * @returns 自身
296
296
  */
297
297
  static error(...messages) {
298
298
  return this.log("error", ...messages);
299
299
  ;
300
300
  }
301
301
  /**让名称为default的logger 产生一条warn等级的log 返回自身
302
- * @param {Array<any>} messages - log消息
303
- * @returns {SLogger} - 自身
302
+ * @param messages - log消息
303
+ * @returns 自身
304
304
  */
305
305
  static warn(...messages) {
306
306
  return this.log("warn", ...messages);
307
307
  ;
308
308
  }
309
309
  /**让名称为default的logger 产生一条info等级的log 返回自身
310
- * @param {Array<any>} messages - log消息
311
- * @returns {SLogger} - 自身
310
+ * @param messages - log消息
311
+ * @returns 自身
312
312
  */
313
313
  static info(...messages) {
314
314
  return this.log("info", ...messages);
315
315
  }
316
316
  /**让名称为default的logger 产生一条http等级的log 返回自身
317
- * @param {Array<any>} messages - log消息
318
- * @returns {SLogger} - 自身
317
+ * @param messages - log消息
318
+ * @returns 自身
319
319
  */
320
320
  static http(...messages) {
321
321
  return this.log("http", ...messages);
322
322
  }
323
323
  /**让名称为default的logger 产生一条verbose等级的log 返回自身
324
- * @param {Array<any>} messages - log消息
325
- * @returns {SLogger} - 自身
324
+ * @param messages - log消息
325
+ * @returns 自身
326
326
  */
327
327
  static verbose(...messages) {
328
328
  return this.log("verbose", ...messages);
329
329
  }
330
330
  /**让名称为default的logger 产生一条debug等级的log 返回自身
331
- * @param {Array<any>} messages - log消息
332
- * @returns {SLogger} - 自身
331
+ * @param messages - log消息
332
+ * @returns 自身
333
333
  */
334
334
  static debug(...messages) {
335
335
  return this.log("debug", ...messages);
336
336
  }
337
337
  /**让名称为default的logger 产生一条silly等级的log 返回自身
338
- * @param {Array<any>} messages - log消息
339
- * @returns {SLogger} - 自身
338
+ * @param messages - log消息
339
+ * @returns 自身
340
340
  */
341
341
  static silly(...messages) {
342
342
  return this.log("silly", ...messages);
343
343
  }
344
344
  /**让名称为default的logger 记录当前时间戳并存入表
345
- * @param {string} flag - 记录的命名
346
- * @returns {HRTimeLog} - 记录的时间
345
+ * @param flag - 记录的命名
346
+ * @returns 记录的时间
347
347
  */
348
348
  static time(flag) {
349
349
  return this.defaultInstance.time(flag);
350
350
  }
351
351
  /**让名称为default的logger 根据之前记录的时间戳计算经过的时间 并输出log
352
- * @param {string} flag - 记录的命名
353
- * @param {LogLevel} level - log等级
354
- * @returns {void}
352
+ * @param flag - 记录的命名
353
+ * @param level - log等级
354
+ * @returns
355
355
  */
356
356
  static timeEnd(flag, level = "info") {
357
357
  this.defaultInstance.timeEnd(flag, level);