0.3.0 • Published 5 years ago
@bnguyensn/logger v0.3.0
Logger 📝
Provides basic logging functionality. Built on top of the wonderful chalk.
Opinionated for my own usage.
Install
Using npm:
$ npm install -D @bnguyensn/logger
Using yarn:
$ yarn add -D @bnguyensn/logger
Usage
Basic usage:
const logger = require('@bnguyensn/logger')();
logger.info('I am blue');
logger.success('I am green');
logger.warn('I am yellow');
logger.error('I am red');
With a base prefix and timestamp:
const logger = require('@bnguyensn/logger')({ base: 'LOG', timestamp: true });
logger.info("I will have 'LOG' prepended and also have a timestamp");
API
createLogger(config)
This is the function exported by the module. You get this from calling
require('@bnguyensn/logger')
.
createLogger()
, when called, will return a Logger
instance.
The config
object by default is undefined
.
config
Property | Type | Description |
---|---|---|
base | string | A string to be prepended to each logging message. |
timestamp | boolean | If true , will add a timestamp to each logging message. |
timestampOptions | object | See below. |
timestampOptions
This object describes how the timestamp for each logging message should look like. We use Node's toLocaleDateString()
under the hood.
Property | Type | Description |
---|---|---|
locale | string \| undefined | See toLocaleDateString() 's locales parameter. If undefined , will attempt to use the system's locale. |
localeOptions | object | See toLocaleDateString() 's options parameter. |
custom | boolean | If true , will ignore both the locale and localeOptions above and use a custom date format. If Node's toLocaleDateString() is not supported, we will fall back to this custom date format. |
Logger
An instance of Logger
is returned from calling createLogger()
.
This Logger
instance can then be used to log stuff to the terminal.
Each Logger
has the following methods:
Method | Description |
---|---|
info(msg) | Log the provided msg in the color blue. |
infoEOL(msg) | Log the provided msg in the color blue and append a new line at the end. |
success(msg) | Log the provided msg in the color green. |
successEOL(msg) | Log the provided msg in the color green and append a new line at the end. |
warn(msg) | Log the provided msg in the color yellow. |
warnEOL(msg) | Log the provided msg in the color yellow and append a new line at the end. |
error(msg) | Log the provided msg in the color red. |
errorEOL(msg) | Log the provided msg in the color red and append a new line at the end. |