logplease
Simple Javascript logger for Node.js and Browsers
DEMO
Open the dev tools to see the log output
logplease does two simple things: output log messages to the console and to a file (Node.js only). Inspired by log4js and debug.
Features
- Log messages to stdout or a file in Node.js or Browsers
- Log levels
- Customize the log messages
- Colors!
Install
npm install logplease
Examples
Node.js
npm run example
Browser
Open example/index.html
in your browser.
Usage
Node.js / Webpack
const Logger = require('logplease');
const logger1 = Logger.create('daemon', { filename: 'debug.log', useColors: false, appendFile: true });
const logger2 = Logger.create('utils', { color: Logger.Colors.Yellow });
const logger3 = Logger.create('logger3', { color: Logger.Colors.Magenta, showTimestamp: false, showLevel: false });
Logger.setLogLevel(Logger.LogLevel.INFO)
const number = 5;
logger1.debug(`This is a log message #${number}`);
logger1.info(`This is a log message #${number}`);
logger1.warn(`This is a log message #${number}`);
logger1.error(`This is a log message #${number}`);
logger2.debug(`This is a log message #${number}`);
logger2.info(`This is a log message #${number}`);
logger2.warn(`This is a log message #${number}`);
logger2.error(`This is a log message #${number}`);
logger3.debug(`This is a log message #${number}`);
logger3.info(`This is a log message #${number}`);
logger3.warn(`This is a log message #${number}`);
logger3.error(`This is a log message #${number}`);
Browser
Copy dist/logplease.min.js
to your javascripts directory and include it in your html. See example/index.html for details.
<body>
<script type="text/javascript" src="logplease.min.js" charset="utf-8"></script>
<script type="text/javascript">
var logger = Logger.create('logger name');
logger.debug(`This is a log message`);
logger.info(`This is a log message`);
logger.warn(`This is a log message`);
logger.error(`This is a log message`);
</script>
</body>
Log level
You can set a global log level to display only the wanted log messages.
const Logger = require('logplease');
Logger.setLogLevel(Logger.LogLevel.ERROR)
Log levels:
DEBUG
INFO
WARN
ERROR
NONE
Colors
You can set a color per logger.
const Logger = require('logplease');
const logger = Logger.create("logger name", { color: Logger.Colors.Yellow });
Colors:
Black, Red, Green, Yellow, Blue, Magenta, Cyan, Grey, White
Options
You can customize your logger.
const Logger = require('logplease');
const logger = Logger.create("logger name", options);
Available options and defaults:
const options = {
useColors: true,
color: Colors.White,
showTimestamp: true,
showLevel: true,
filename: null,
appendFile: true,
};
Build
Install build dependencies:
npm install
The build command will build the browser distributable. Note that for Node.js it is not needed to run the build command.
npm run dist
The distributable file will be located in dist/logplease.min.js
Build the browser example:
npm run example:browser