m-web-logger v0.4.1

m-web-logger

A simple logger util for browser/nodejs development. It's a practice for decorators(experimental) in TypeScript.

(btw, I found ChatGPT can easily do better than this, T T)

install

npm install m-web-logger

Log types & default setting

m-logger has 5 levels, you can pass it by url params or by node argv, default is slient.

log level values are below:

• slient: no log (for production)
• error: only error log
• warn: includes warning, error
• info: includes warning, error, info
• all: includes warning, error, info, log

you can also change the level by setting each logger instance, or use label filter.

Priority comparison: label filter > instance's level > default log level

Browser setting

you can check browser demo by npm run dev.

browser's log level setting is controlled by url query parameter log_level.

For example: {your-web-location}?log_level=${level}. you can change default level by change level

you can also filter log info by label_filter

Nodejs setting

you can check Nodejs demo by npm run test.

Node.js's log setting is controlled by process.env or process.argv

For example:

set label_filter=${label}
set log_level=${level}
node your_script.js

# or
node your_script.js --label_filter=${label}
node your_script.js --log_level=${level}

basic usage

• create a logger

  // es module
  import { Logger, LogLevel } from "m-web-logger";
  
  // umd from browser window
  const { MLogger } = window;
  const { Logger, LogLevel } = MLogger;
  
  // default usage
  const logger = new Logger();
  // or pass label or level to it
  const logger1 = new Logger({
    label: "some-module",
    level: LogLevel.warn,
  });

• basic use

  logger.log(1);
  logger.info(1, 2);
  logger.warn(1, 2, 3);
  logger.error(1, 2, 3, 4);
  
  const obj = { a: "hello world" };
  logger.log(obj);
  logger.info(1, obj);
  logger.warn(1, 2, obj);
  logger.error(1, 2, 3, obj);

• setting a label for bug trace

  you can define a label for more-specific log information.

  logger.setLabel("define-label");
  logger.log(obj);
  logger.info(1, obj);
  logger.warn(1, 2, obj);
  logger.error(1, 2, 3, obj);

• setting level for filter

  you can change log url params or use setLevel method to filter log information.

  // change the url params log to `error`
  // or use setLevel
  logger.setLevel(LogLevel.error);
  logger.log(obj); // filtered
  logger.info(1, obj); // filtered
  logger.warn(1, 2, obj); // filtered
  logger.error("after set-lelve, you can only see error log");

• Use Interceptor

  you can use Interceptor function to get log event.

  const logger1 = new Logger({
    label: "interceptor-log",
  });
  const logger2 = new Logger({
    label: "some-module",
  });
  // catch logger event here
  Logger.useInterceptor((config, ...args) => {
    const { instance, level } = config;
    // get 'some-module' error-event
    if (instance.label === "some-module" && level === LogLevel.error) {
      logger1.warn("Interceptor get [some-module] error event. do something");
    }
  });
  logger2.error("some error event;");

development

# for browser
npm run dev

# for nodejs, example
npm run test -- --log=error

build

npm run build