@wiajs/log 4.3.15 → 4.3.17

package/dist/log.mjs

@@ -9,135 +9,132 @@
  * m 为模块，fn 为函数名称
  */
 class Log {
-	/** @type {string} 模块 */
-	m = "";
-
-	/** @type {string} 函数 */
-	fn = "";
-
-	/**
-	 * @param {string} m 模块
-	 */
-	constructor(m) {
-		this.m = m;
-	}
-
-	/**
-	 * get log desc
-	 * 描述字符串作为最后参数调用，显示时，前置
-	 * @param {*[]} args
-	 * @returns {{desc: string, arg: *[]}}
-	 */
-	getDesc(args) {
-		let R = {desc: '', arg: args};
-		try {
-			const _ = this;
-			const { m } = _;
-			let fn = "";
-			let desc = "";
-
-			if (args.length > 1) {
-				const last = args.at(-1);
-				if (typeof last === "object") {
-					({ desc, fn } = last);
-				} else if (typeof last === "string") desc = last;
-				if (desc || fn) {
-					fn = fn || _.fn;
-					_.fn = fn;
-					args.pop();
-				}
-			}
-			fn = fn || _.fn;
-			if (m) desc = `${desc}[${m}${fn ? `:${fn}` : ""}]`; // eslint-disable-line
-			R = {desc, arg: args};
-		} catch (e) {
-			console.error(`getDesc exp:${e.message}`);
-		}
-
-		return R;
-	}
-
-	/** @param {...any} args - params */
-	log(...args) {
-		const _ = this;
-		const last = args.at(-1);
-		// clear fn
-		if (args.length === 1 && typeof last === "object" && last.fn) _.fn = "";
-		else {
-			const desc = _.getDesc(args);
-			console.log(desc, ...args);
-		}
-	}
-
-	/** @param {...any} args - params */
-	debug(...args) {
-		const _ = this;
-		const desc = _.getDesc(args);
-		if (desc) console.log(desc, ...args);
-		else console.log(...args);
-	}
-
-	/** @param {...any} args - params */
-	info(...args) {
-		const _ = this;
-		const desc = _.getDesc(args);
-		if (desc) console.info(desc, ...args);
-		else console.log(...args);
-	}
-
-	/** @param {...any} args - params */
-	warn(...args) {
-		const _ = this;
-		const { desc, arg } = _.getDesc(args);
-		if (desc) console.warn(desc, ...arg);
-		else console.log(...args);
-	}
-
-	/** @param {...any} args - params */
-	trace(...args) {
-		const _ = this;
-		const { desc, arg } = _.getDesc(args);
-		if (desc) console.trace(desc, ...arg);
-		else console.trace(...args);
-	}
-
-	/** @param {...any} args - params */
-	error(...args) {
-		const _ = this;
-		const {desc, arg} = _.getDesc(args);
-		if (desc) console.error(desc, ...arg);
-		else console.log(...args);
-	}
-
-	/**
-	 * 用于 catch(e) log.err(e)
-	 * @param {...any} args - params */
-	err(...args) {
-		const _ = this;
-		const first = args?.[0];
-		if (
-			first instanceof Error ||
-			(first?.message && first?.cause && first?.stack)
-		)
-			args[0] = { exp: args[0].message };
-		_.error(...args);
-	}
+  /** @type {string} 模块 */
+  m = ''
+
+  /** @type {string} 函数 */
+  fn = ''
+
+  /**
+   * @param {string} m 模块
+   */
+  constructor(m) {
+    this.m = m;
+  }
+
+  /**
+   * get log desc
+   * 描述字符串作为最后参数调用，显示时，前置
+   * @param {*[]} args
+   * @returns {{desc: string, arg: *[]}}
+   */
+  getDesc(args) {
+    let R = {desc: '', arg: args};
+    try {
+      const _ = this;
+      const {m} = _;
+      let fn = '';
+      let desc = '';
+
+      if (args.length > 1) {
+        const last = args.at(-1);
+        if (typeof last === 'object') {
+          ;({desc, fn} = last);
+        } else if (typeof last === 'string') desc = last;
+        if (desc || fn) {
+          fn = fn || _.fn;
+          _.fn = fn;
+          args.pop();
+        }
+      }
+      fn = fn || _.fn;
+      if (m) desc = `${desc}[${m}${fn ? `:${fn}` : ''}]`; // eslint-disable-line
+      R = {desc, arg: args};
+    } catch (e) {
+      console.error(`getDesc exp:${e.message}`);
+    }
+
+    return R
+  }
+
+  /** @param {...any} args - params */
+  log(...args) {
+    const _ = this;
+    const last = args.at(-1);
+    // clear fn
+    if (args.length === 1 && typeof last === 'object' && last.fn) _.fn = '';
+    else {
+      const desc = _.getDesc(args);
+      console.log(desc, ...args);
+    }
+  }
+
+  /** @param {...any} args - params */
+  debug(...args) {
+    const _ = this;
+    const desc = _.getDesc(args);
+    if (desc) console.log(desc, ...args);
+    else console.log(...args);
+  }
+
+  /** @param {...any} args - params */
+  info(...args) {
+    const _ = this;
+    const desc = _.getDesc(args);
+    if (desc) console.info(desc, ...args);
+    else console.log(...args);
+  }
+
+  /** @param {...any} args - params */
+  warn(...args) {
+    const _ = this;
+    const {desc, arg} = _.getDesc(args);
+    if (desc) console.warn(desc, ...arg);
+    else console.log(...args);
+  }
+
+  /** @param {...any} args - params */
+  trace(...args) {
+    const _ = this;
+    const {desc, arg} = _.getDesc(args);
+    if (desc) console.trace(desc, ...arg);
+    else console.trace(...args);
+  }
+
+  /** @param {...any} args - params */
+  error(...args) {
+    const _ = this;
+    const {desc, arg} = _.getDesc(args);
+    if (desc) console.error(desc, ...arg);
+    else console.log(...args);
+  }
+
+  /**
+   * 用于 catch(e) log.err(e)
+   * @param {...any} args - params */
+  err(...args) {
+    const _ = this;
+    const first = args?.[0];
+    if (first instanceof Error || (first?.message && first?.cause && first?.stack))
+      args[0] = {exp: args[0].message};
+    _.error(...args);
+  }
 }
 
 /**
  * get log desc
  * 描述字符串作为最后参数调用，显示时，前置
- * @param {*[]} args 
+ * @param {*[]} args
  * @returns {{desc: string, arg: *[]}}
  */
 function getDesc(args) {
-	let desc = "";
-	const last = args.at(-1);
-	if (typeof last === "string") {
-		desc = last;
-		args.pop();
-	}
-	return {desc, arg: args};
+  let desc = '';
+  const last = args.at(-1);
+  if (typeof last === 'string') {
+    desc = last;
+    args.pop();
+  }
+  return {desc, arg: args}
 }
 
 /**
@@ -147,77 +144,74 @@ function getDesc(args) {
  * returns {*}
  */
 function log(...args) {
-	const last = args.at(-1);
-
-	// 全局日志
-	if (args.length !== 1 || !last?.m) {
-		const desc = getDesc(args);
-		desc ? console.log(desc, ...args) : console.log(...args);
-		return; // 退出，不创建实例
-	}
-
-	// 唯一 m 属性，则构造新的 log 实例，这种写法，能被jsDoc识别子属性
-	const lg = new Log(last?.m);
-	/** @param {*} args2 */
-	const R = (...args2) => lg.log(...args2);
-	R.debug = lg.debug.bind(lg);
-	R.info = lg.info.bind(lg);
-	R.warn = lg.warn.bind(lg);
-	R.info = lg.info.bind(lg);
-	R.trace = lg.trace.bind(lg);
-	R.error = lg.error.bind(lg);
-	R.err = lg.err.bind(lg);
-
-	return R;
+  const last = args.at(-1);
+
+  // 全局日志
+  if (args.length !== 1 || !last?.m) {
+    const desc = getDesc(args);
+    desc ? console.log(desc, ...args) : console.log(...args);
+    return // 退出，不创建实例
+  }
+
+  // 唯一 m 属性，则构造新的 log 实例，这种写法，能被jsDoc识别子属性
+  const lg = new Log(last?.m);
+  /** @param {*} args2 */
+  const R = (...args2) => lg.log(...args2);
+  R.debug = lg.debug.bind(lg);
+  R.info = lg.info.bind(lg);
+  R.warn = lg.warn.bind(lg);
+  R.info = lg.info.bind(lg);
+  R.trace = lg.trace.bind(lg);
+  R.error = lg.error.bind(lg);
+  R.err = lg.err.bind(lg);
+
+  return R
 }
 
 /**
  * 用于 catch(e) log.err(e)
  * @param {...any} args - params */
 log.err = (...args) => {
-	const {desc, arg} = getDesc(args);
-	const first = args?.[0];
-	if (
-		first instanceof Error ||
-		(first?.message && first?.cause && first?.stack)
-	)
-		args[0] = { exp: args[0].message };
-	desc ? console.error(desc, ...arg) : console.error(...args);
+  const {desc, arg} = getDesc(args);
+  const first = args?.[0];
+  if (first instanceof Error || (first?.message && first?.cause && first?.stack))
+    args[0] = {exp: args[0].message};
+  desc ? console.error(desc, ...arg) : console.error(...args);
 };
 
 /**
  * @param {...any} args - params */
 log.error = (...args) => {
-	const {desc, arg} = getDesc(args);
-	desc ? console.error(desc, ...arg) : console.error(...args);
+  const {desc, arg} = getDesc(args);
+  desc ? console.error(desc, ...arg) : console.error(...args);
 };
 
 /**
  * @param {...any} args - params */
 log.warn = (...args) => {
-	const {desc, arg} = getDesc(args);
-	desc ? console.warn(desc, ...arg) : console.warn(...args);
+  const {desc, arg} = getDesc(args);
+  desc ? console.warn(desc, ...arg) : console.warn(...args);
 };
 
 /**
  * @param {...any} args - params */
 log.info = (...args) => {
-	const {desc, arg} = getDesc(args);
-	desc ? console.info(desc, ...arg) : console.info(...args);
+  const {desc, arg} = getDesc(args);
+  desc ? console.info(desc, ...arg) : console.info(...args);
 };
 
 /**
  * @param {...any} args - params */
 log.debug = (...args) => {
-	const {desc, arg} = getDesc(args);
-	desc ? console.log(desc, ...arg) : console.log(...args);
+  const {desc, arg} = getDesc(args);
+  desc ? console.log(desc, ...arg) : console.log(...args);
 };
 
 /**
  * @param {...any} args - params */
 log.trace = (...args) => {
-	const {desc, arg} = getDesc(args);
-	desc ? console.trace(desc, ...arg) : console.trace(...args);
+  const {desc, arg} = getDesc(args);
+  desc ? console.trace(desc, ...arg) : console.trace(...args);
 };
 
 export { log as default };

package/lib/browser.js

@@ -4,28 +4,33 @@
  * m 为模块，fn 为函数名称
  */ let Log = class Log {
     /**
-	 * @param {string} m 模块
-	 */ constructor(m){
-        /** @type {string} 模块 */ this.m = "";
-        /** @type {string} 函数 */ this.fn = "";
+   * @param {string} m 模块
+   */ constructor(m){
+        /** @type {string} 模块 */ this.m = '';
+        /** @type {string} 函数 */ this.fn = '';
         this.m = m;
     }
     /**
-	 * get log desc
-	 * 描述字符串后置调用，前置显示
-	 * @param {*[]} args
-	 * @returns {string}
-	 */ getDesc(args) {
-        let R = "";
+   * get log desc
+   * 描述字符串作为最后参数调用，显示时，前置
+   * @param {*[]} args
+   * @returns {{desc: string, arg: *[]}}
+   */ getDesc(args) {
+        let R = {
+            desc: '',
+            arg: args
+        };
         try {
             const _ = this;
             const { m } = _;
-            let fn = "", desc = "";
+            let fn = '';
+            let desc = '';
             if (args.length > 1) {
                 const last = args.at(-1);
-                if (typeof last === "object") {
+                if (typeof last === 'object') {
+                    ;
                     ({ desc, fn } = last);
-                } else if (typeof last === "string") desc = last;
+                } else if (typeof last === 'string') desc = last;
                 if (desc || fn) {
                     fn = fn || _.fn;
                     _.fn = fn;
@@ -33,8 +38,12 @@
                 }
             }
             fn = fn || _.fn;
-            if (m) desc = `${desc}[${m}${fn ? ":" + fn : ""}]`; // eslint-disable-line
-            R = desc;
+            if (m) desc = `${desc}[${m}${fn ? `:${fn}` : ''}]` // eslint-disable-line
+            ;
+            R = {
+                desc,
+                arg: args
+            };
         } catch (e) {
             console.error(`getDesc exp:${e.message}`);
         }
@@ -44,7 +53,7 @@
         const _ = this;
         const last = args.at(-1);
         // clear fn
-        if (args.length === 1 && typeof last === "object" && last.fn) _.fn = "";
+        if (args.length === 1 && typeof last === 'object' && last.fn) _.fn = '';
         else {
             const desc = _.getDesc(args);
             console.log(desc, ...args);
@@ -76,29 +85,37 @@
     }
     /** @param {...any} args - params */ error(...args) {
         const _ = this;
-        const desc = _.getDesc(args);
-        if (desc) console.error(desc, ...args);
+        const { desc, arg } = _.getDesc(args);
+        if (desc) console.error(desc, ...arg);
         else console.log(...args);
     }
     /**
-	 * 用于 catch(e) log.err(e)
-	 * @param {...any} args - params */ err(...args) {
+   * 用于 catch(e) log.err(e)
+   * @param {...any} args - params */ err(...args) {
         const _ = this;
         const first = args?.[0];
-        if (first instanceof Error || first && first.message && first.cause && first.stack) args[0] = {
+        if (first instanceof Error || first?.message && first?.cause && first?.stack) args[0] = {
             exp: args[0].message
         };
         _.error(...args);
     }
 };
-function getDesc(args) {
-    let desc = "";
+/**
+ * get log desc
+ * 描述字符串作为最后参数调用，显示时，前置
+ * @param {*[]} args
+ * @returns {{desc: string, arg: *[]}}
+ */ function getDesc(args) {
+    let desc = '';
     const last = args.at(-1);
-    if (typeof last === "string") {
+    if (typeof last === 'string') {
         desc = last;
         args.pop();
     }
-    return desc;
+    return {
+        desc,
+        arg: args
+    };
 }
 /**
  * 标准日志输出或构建模块日志类实例，用于模块中带[m:xxx]标记日志输出
@@ -111,7 +128,7 @@ function getDesc(args) {
     if (args.length !== 1 || !last?.m) {
         const desc = getDesc(args);
         desc ? console.log(desc, ...args) : console.log(...args);
-        return;
+        return; // 退出，不创建实例
     }
     // 唯一 m 属性，则构造新的 log 实例，这种写法，能被jsDoc识别子属性
     const lg = new Log(last?.m);
@@ -128,49 +145,36 @@ function getDesc(args) {
 /**
  * 用于 catch(e) log.err(e)
  * @param {...any} args - params */ log.err = (...args)=>{
-    const desc = getDesc(args);
+    const { desc, arg } = getDesc(args);
     const first = args?.[0];
-    if (first instanceof Error || first && first.message && first.cause && first.stack) args[0] = {
+    if (first instanceof Error || first?.message && first?.cause && first?.stack) args[0] = {
         exp: args[0].message
     };
-    desc ? console.error(desc, ...args) : console.error(...args);
+    desc ? console.error(desc, ...arg) : console.error(...args);
 };
 /**
  * @param {...any} args - params */ log.error = (...args)=>{
-    const desc = getDesc(args);
-    desc ? console.error(desc, ...args) : console.error(...args);
+    const { desc, arg } = getDesc(args);
+    desc ? console.error(desc, ...arg) : console.error(...args);
 };
 /**
  * @param {...any} args - params */ log.warn = (...args)=>{
-    const desc = getDesc(args);
-    desc ? console.warn(desc, ...args) : console.warn(...args);
+    const { desc, arg } = getDesc(args);
+    desc ? console.warn(desc, ...arg) : console.warn(...args);
 };
 /**
  * @param {...any} args - params */ log.info = (...args)=>{
-    const desc = getDesc(args);
-    desc ? console.info(desc, ...args) : console.info(...args);
+    const { desc, arg } = getDesc(args);
+    desc ? console.info(desc, ...arg) : console.info(...args);
 };
 /**
  * @param {...any} args - params */ log.debug = (...args)=>{
-    const desc = getDesc(args);
-    desc ? console.log(desc, ...args) : console.log(...args);
+    const { desc, arg } = getDesc(args);
+    desc ? console.log(desc, ...arg) : console.log(...args);
 };
 /**
  * @param {...any} args - params */ log.trace = (...args)=>{
-    const desc = getDesc(args);
-    desc ? console.trace(desc, ...args) : console.trace(...args);
+    const { desc, arg } = getDesc(args);
+    desc ? console.trace(desc, ...arg) : console.trace(...args);
 };
-/**
- * 获取模块文件名称
- * esm: import.meta.url or cjs: __filename
- * @param {string} file
- * @returns
- */ function name(file) {
-    // import.meta.url: 'file:///D:/prj/wiajs/req/test/log.t.js'
-    // file = fileURLToPath(file) // fileUrl 转成路径
-    // const baseName = path.basename(file)
-    // return baseName.replace(path.extname(baseName), '')
-    return '';
-}
-export { name, log }; // export default log;
- // export { log, Log };
+export default log;

package/lib/node.js

@@ -23,17 +23,17 @@ import debug from 'debug';
    */ constructor(opts){
         let { env } = opts;
         env = env ?? '';
-        const ds = {} // debugs
+        const dgs = {} // debugs
         ;
-        ds.debug = debug(`${env}`);
-        ds.info = debug(`${env}:info`);
-        ds.err = debug(`${env}:err`);
-        ds.warn = debug(`${env}:warn`);
+        dgs.debug = debug(`${env}`);
+        dgs.info = debug(`${env}:info`);
+        dgs.err = debug(`${env}:err`);
+        dgs.warn = debug(`${env}:warn`);
         // 仅最后调用生效，覆盖环境变量
-        if (ds.debug.enabled) debug.enable('*');
-        else if (ds.info.enabled) debug.enable(`${env}:info,${env}:err,${env}:warn`);
+        if (dgs.debug.enabled) debug.enable('*');
+        else if (dgs.info.enabled) debug.enable(`${env}:info,${env}:err,${env}:warn`);
         else debug.enable(`${env}:err,${env}:warn`);
-        this.ds = ds;
+        this.dgs = dgs;
     }
     /**
    *
@@ -42,9 +42,9 @@ import debug from 'debug';
         const first = args?.at(0);
         const last = args?.at(-1);
         if (typeof first === 'string') {
-            args[0] = `${first}`;
-            this.ds.debug(...args);
-        } else if (typeof first === 'object' && typeof last === 'string') this.ds.debug(`${last}:%O`, first);
+            args.shift();
+            this.dgs.debug(first, ...args);
+        } else if (typeof first === 'object' && typeof last === 'string') this.dgs.debug(`${last}:%O`, first);
     // args[0] = `${this.pre}:${args[0]}`
     // console.debug(...args)
     // console.debug(this.pre, ...args)
@@ -56,9 +56,9 @@ import debug from 'debug';
         const first = args?.at(0);
         const last = args?.at(-1);
         if (typeof first === 'string') {
-            args[0] = ` ${first}`;
-            this.ds.err(...args);
-        } else if (typeof first === 'object' && typeof last === 'string') this.ds.err(` ${last}:%O`, first);
+            args.shift();
+            this.dgs.err(` ${first}`, ...args);
+        } else if (typeof first === 'object' && typeof last === 'string') this.dgs.err(` ${last}:%O`, first);
     }
     /**
    *
@@ -79,8 +79,10 @@ import debug from 'debug';
    */ warn(...args) {
         const first = args?.at(0);
         const last = args?.at(-1);
-        if (typeof first === 'string') this.ds.warn(...args);
-        else if (typeof first === 'object' && typeof last === 'string') this.ds.warn(`${last}:%O`, first);
+        if (typeof first === 'string') {
+            args.shift();
+            this.dgs.warn(first, ...args);
+        } else if (typeof first === 'object' && typeof last === 'string') this.dgs.warn(`${last}:%O`, first);
     }
     /**
    *
@@ -88,8 +90,12 @@ import debug from 'debug';
    */ info(...args) {
         const first = args?.at(0);
         const last = args?.at(-1);
-        if (typeof first === 'string') this.ds.info(...args);
-        else if (typeof first === 'object' && typeof last === 'string') this.ds.info(`${last}:%O`, first);
+        // const dg = debug('ab')
+        // dg()
+        if (typeof first === 'string') {
+            args.shift();
+            this.dgs.info(first, ...args);
+        } else if (typeof first === 'object' && typeof last === 'string') this.dgs.info(`${last}:%O`, first);
     }
 }
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wiajs/log",
   "description": "Lightweight debugging utility for Node.js and the browser",
-  "version": "4.3.15",
+  "version": "4.3.17",
   "type": "module",
   "main": "index.js",
   "types": "./types/log.d.ts", 

package/types/browser.d.ts

@@ -0,0 +1,18 @@
+export default log;
+declare function log(...args: any[]): {
+    (...args2: any): void;
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    trace: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    err: (...args: any[]) => void;
+};
+declare namespace log {
+    function err(...args: any[]): void;
+    function error(...args: any[]): void;
+    function warn(...args: any[]): void;
+    function info(...args: any[]): void;
+    function debug(...args: any[]): void;
+    function trace(...args: any[]): void;
+}