@wiajs/log 4.3.19 → 4.3.20

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/log.bs.cjs CHANGED
@@ -1,221 +1,179 @@
1
1
  /*!
2
- * wia log v4.3.19
3
- * (c) 2024-2024 Sibyl Yu and contributors
2
+ * wia log v4.3.20
3
+ * (c) 2024-2025 Sibyl Yu and contributors
4
4
  * Released under the MIT License.
5
5
  */
6
6
  'use strict';
7
7
 
8
- Object.defineProperty(exports, '__esModule', { value: true });
9
-
10
8
  /**
11
9
  * 前端日志输出,封装 console日志,简化代码,支持模块或直接输出
12
10
  * 调用时,描述字符串后置,便于可选缺省,输出时,自带前置,类似 后端pino,保持前后端一致性
13
11
  * m 为模块,fn 为函数名称
14
- */
15
- class Log {
16
- /** @type {string} 模块 */
17
- m = ''
18
-
19
- /** @type {string} 函数 */
20
- fn = ''
21
-
22
- /**
23
- * @param {string} m 模块
24
- */
25
- constructor(m) {
26
- this.m = m;
27
- }
28
-
29
- /**
12
+ */ let Log = class Log {
13
+ /**
30
14
  * get log desc
31
- * 描述字符串作为最后参数调用,显示时,前置
15
+ * 描述字符串后置调用,前置显示
32
16
  * @param {*[]} args
33
- * @returns {{desc: string, arg: *[]}}
34
- */
35
- getDesc(args) {
36
- let R = {desc: '', arg: args};
37
- try {
38
- const _ = this;
39
- const {m} = _;
40
- let fn = '';
41
- let desc = '';
42
-
43
- if (args.length > 1) {
44
- const last = args.at(-1);
45
- if (typeof last === 'object') {
46
- ;({desc, fn} = last);
47
- } else if (typeof last === 'string') desc = last;
48
- if (desc || fn) {
49
- fn = fn || _.fn;
50
- _.fn = fn;
51
- args.pop();
52
- }
53
- }
54
- fn = fn || _.fn;
55
- if (m) desc = `${desc}[${m}${fn ? `:${fn}` : ''}]`; // eslint-disable-line
56
- R = {desc, arg: args};
57
- } catch (e) {
58
- console.error(`getDesc exp:${e.message}`);
59
- }
60
-
61
- return R
62
- }
63
-
64
- /** @param {...any} args - params */
65
- log(...args) {
66
- const _ = this;
67
- const last = args.at(-1);
68
- // clear fn
69
- if (args.length === 1 && typeof last === 'object' && last.fn) _.fn = '';
70
- else {
71
- const desc = _.getDesc(args);
72
- console.log(desc, ...args);
73
- }
74
- }
75
-
76
- /** @param {...any} args - params */
77
- debug(...args) {
78
- const _ = this;
79
- const desc = _.getDesc(args);
80
- if (desc) console.log(desc, ...args);
81
- else console.log(...args);
82
- }
83
-
84
- /** @param {...any} args - params */
85
- info(...args) {
86
- const _ = this;
87
- const desc = _.getDesc(args);
88
- if (desc) console.info(desc, ...args);
89
- else console.log(...args);
90
- }
91
-
92
- /** @param {...any} args - params */
93
- warn(...args) {
94
- const _ = this;
95
- const {desc, arg} = _.getDesc(args);
96
- if (desc) console.warn(desc, ...arg);
97
- else console.log(...args);
98
- }
99
-
100
- /** @param {...any} args - params */
101
- trace(...args) {
102
- const _ = this;
103
- const {desc, arg} = _.getDesc(args);
104
- if (desc) console.trace(desc, ...arg);
105
- else console.trace(...args);
106
- }
107
-
108
- /** @param {...any} args - params */
109
- error(...args) {
110
- const _ = this;
111
- const {desc, arg} = _.getDesc(args);
112
- if (desc) console.error(desc, ...arg);
113
- else console.log(...args);
114
- }
115
-
116
- /**
17
+ * @returns {string}
18
+ */ getDesc(args) {
19
+ let R = '';
20
+ try {
21
+ const _ = this;
22
+ const { m } = _;
23
+ let fn = '', desc = '';
24
+ if (args.length > 1) {
25
+ const last = args.at(-1);
26
+ if (typeof last === 'object') {
27
+ ;
28
+ ({ desc, fn } = last);
29
+ } else if (typeof last === 'string') desc = last;
30
+ if (desc || fn) {
31
+ fn = fn || _.fn;
32
+ _.fn = fn;
33
+ args.pop();
34
+ }
35
+ }
36
+ fn = fn || _.fn;
37
+ if (m) desc = `${desc}[${m}${fn ? ':' + fn : ''}]` // eslint-disable-line
38
+ ;
39
+ R = desc;
40
+ } catch (e) {
41
+ console.error(`getDesc exp:${e.message}`);
42
+ }
43
+ return R;
44
+ }
45
+ /** @param {...any} args - params */ log(...args) {
46
+ const _ = this;
47
+ const last = args.at(-1);
48
+ // clear fn
49
+ if (args.length === 1 && typeof last === 'object' && last.fn) _.fn = '';
50
+ else {
51
+ const desc = _.getDesc(args);
52
+ console.log(desc, ...args);
53
+ }
54
+ }
55
+ /** @param {...any} args - params */ debug(...args) {
56
+ const _ = this;
57
+ const desc = _.getDesc(args);
58
+ if (desc) console.log(desc, ...args);
59
+ else console.log(...args);
60
+ }
61
+ /** @param {...any} args - params */ info(...args) {
62
+ const _ = this;
63
+ const desc = _.getDesc(args);
64
+ if (desc) console.info(desc, ...args);
65
+ else console.log(...args);
66
+ }
67
+ /** @param {...any} args - params */ warn(...args) {
68
+ const _ = this;
69
+ const { desc, arg } = _.getDesc(args);
70
+ if (desc) console.warn(desc, ...arg);
71
+ else console.log(...args);
72
+ }
73
+ /** @param {...any} args - params */ trace(...args) {
74
+ const _ = this;
75
+ const { desc, arg } = _.getDesc(args);
76
+ if (desc) console.trace(desc, ...arg);
77
+ else console.trace(...args);
78
+ }
79
+ /** @param {...any} args - params */ error(...args) {
80
+ const _ = this;
81
+ const desc = _.getDesc(args);
82
+ if (desc) console.error(desc, ...args);
83
+ else console.log(...args);
84
+ }
85
+ /**
117
86
  * 用于 catch(e) log.err(e)
118
- * @param {...any} args - params */
119
- err(...args) {
120
- const _ = this;
121
- const first = args?.[0];
122
- if (first instanceof Error || (first?.message && first?.cause && first?.stack))
123
- args[0] = {exp: args[0].message};
124
- _.error(...args);
125
- }
126
- }
127
-
87
+ * @param {...any} args - params */ err(...args) {
88
+ const _ = this;
89
+ const first = args == null ? void 0 : args[0];
90
+ if (first instanceof Error || first && first.message && first.cause && first.stack) args[0] = {
91
+ exp: args[0].message
92
+ };
93
+ _.error(...args);
94
+ }
95
+ /**
96
+ * @param {string} m 模块
97
+ */ constructor(m){
98
+ /** @type {string} 模块 */ this.m = '';
99
+ /** @type {string} 函数 */ this.fn = '';
100
+ this.m = m;
101
+ }
102
+ };
128
103
  /**
129
104
  * get log desc
130
105
  * 描述字符串作为最后参数调用,显示时,前置
131
106
  * @param {*[]} args
132
107
  * @returns {{desc: string, arg: *[]}}
133
- */
134
- function getDesc(args) {
135
- let desc = '';
136
- const last = args.at(-1);
137
- if (typeof last === 'string') {
138
- desc = last;
139
- args.pop();
140
- }
141
- return {desc, arg: args}
142
- }
143
-
108
+ */ function getDesc(args) {
109
+ let desc = '';
110
+ const last = args.at(-1);
111
+ if (typeof last === 'string') {
112
+ desc = last;
113
+ args.pop();
114
+ }
115
+ return desc;
116
+ }
144
117
  /**
145
118
  * 标准日志输出或构建模块日志类实例,用于模块中带[m:xxx]标记日志输出
146
119
  * 启用 {f:fn} 标记时,需在函数尾部清除f(log({f:''})),否则会溢出到其他函数
147
120
  * @param {...any} args - params
148
121
  * returns {*}
149
- */
150
- function log(...args) {
151
- const last = args.at(-1);
152
-
153
- // 全局日志
154
- if (args.length !== 1 || !last?.m) {
155
- const desc = getDesc(args);
156
- desc ? console.log(desc, ...args) : console.log(...args);
157
- return // 退出,不创建实例
158
- }
159
-
160
- // 唯一 m 属性,则构造新的 log 实例,这种写法,能被jsDoc识别子属性
161
- const lg = new Log(last?.m);
162
- /** @param {*} args2 */
163
- const R = (...args2) => lg.log(...args2);
164
- R.debug = lg.debug.bind(lg);
165
- R.info = lg.info.bind(lg);
166
- R.warn = lg.warn.bind(lg);
167
- R.info = lg.info.bind(lg);
168
- R.trace = lg.trace.bind(lg);
169
- R.error = lg.error.bind(lg);
170
- R.err = lg.err.bind(lg);
171
-
172
- return R
173
- }
174
-
122
+ */ function log(...args) {
123
+ const last = args.at(-1);
124
+ // 全局日志
125
+ if (args.length !== 1 || !(last == null ? void 0 : last.m)) {
126
+ const desc = getDesc(args);
127
+ desc ? console.log(desc, ...args) : console.log(...args);
128
+ return; // 退出,不创建实例
129
+ }
130
+ // 唯一 m 属性,则构造新的 log 实例,这种写法,能被jsDoc识别子属性
131
+ const lg = new Log(last == null ? void 0 : last.m);
132
+ /** @param {*} args2 */ const R = (...args2)=>lg.log(...args2);
133
+ R.debug = lg.debug.bind(lg);
134
+ R.info = lg.info.bind(lg);
135
+ R.warn = lg.warn.bind(lg);
136
+ R.info = lg.info.bind(lg);
137
+ R.trace = lg.trace.bind(lg);
138
+ R.error = lg.error.bind(lg);
139
+ R.err = lg.err.bind(lg);
140
+ return R;
141
+ }
175
142
  /**
176
143
  * 用于 catch(e) log.err(e)
177
- * @param {...any} args - params */
178
- log.err = (...args) => {
179
- const {desc, arg} = getDesc(args);
180
- const first = args?.[0];
181
- if (first instanceof Error || (first?.message && first?.cause && first?.stack))
182
- args[0] = {exp: args[0].message};
183
- desc ? console.error(desc, ...arg) : console.error(...args);
184
- };
185
-
144
+ * @param {...any} args - params */ log.err = (...args)=>{
145
+ const desc = getDesc(args);
146
+ const first = args == null ? void 0 : args[0];
147
+ if (first instanceof Error || first && first.message && first.cause && first.stack) args[0] = {
148
+ exp: args[0].message
149
+ };
150
+ desc ? console.error(desc, ...args) : console.error(...args);
151
+ };
186
152
  /**
187
- * @param {...any} args - params */
188
- log.error = (...args) => {
189
- const {desc, arg} = getDesc(args);
190
- desc ? console.error(desc, ...arg) : console.error(...args);
191
- };
192
-
153
+ * @param {...any} args - params */ log.error = (...args)=>{
154
+ const desc = getDesc(args);
155
+ desc ? console.error(desc, ...args) : console.error(...args);
156
+ };
193
157
  /**
194
- * @param {...any} args - params */
195
- log.warn = (...args) => {
196
- const {desc, arg} = getDesc(args);
197
- desc ? console.warn(desc, ...arg) : console.warn(...args);
198
- };
199
-
158
+ * @param {...any} args - params */ log.warn = (...args)=>{
159
+ const desc = getDesc(args);
160
+ desc ? console.warn(desc, ...args) : console.warn(...args);
161
+ };
200
162
  /**
201
- * @param {...any} args - params */
202
- log.info = (...args) => {
203
- const {desc, arg} = getDesc(args);
204
- desc ? console.info(desc, ...arg) : console.info(...args);
205
- };
206
-
163
+ * @param {...any} args - params */ log.info = (...args)=>{
164
+ const desc = getDesc(args);
165
+ desc ? console.info(desc, ...args) : console.info(...args);
166
+ };
207
167
  /**
208
- * @param {...any} args - params */
209
- log.debug = (...args) => {
210
- const {desc, arg} = getDesc(args);
211
- desc ? console.log(desc, ...arg) : console.log(...args);
212
- };
213
-
168
+ * @param {...any} args - params */ log.debug = (...args)=>{
169
+ const desc = getDesc(args);
170
+ desc ? console.log(desc, ...args) : console.log(...args);
171
+ };
214
172
  /**
215
- * @param {...any} args - params */
216
- log.trace = (...args) => {
217
- const {desc, arg} = getDesc(args);
218
- desc ? console.trace(desc, ...arg) : console.trace(...args);
173
+ * @param {...any} args - params */ log.trace = (...args)=>{
174
+ const desc = getDesc(args);
175
+ desc ? console.trace(desc, ...args) : console.trace(...args);
219
176
  };
220
177
 
221
- exports.default = log;
178
+ exports.Log = Log;
179
+ exports.log = log;