ss-logger
A super simple JavaScript logger. It allows labels/tags, custom logging levels, custom output formatting and it's small. It has no dependancies.
Examples
// Standard usageconst log = ; log;log;log; // Output:// stdout: 2017-03-10T09:44:06.391Z info: My first info line.// stderr: 2017-03-10T09:44:06.396Z warn: {"my_obj":"a"}// stderr: 2017-03-10T09:44:06.394Z error: My first error line.
Meta
- license: Apache-2.0
createLogger
The ss-logger
module returns createLogger()
by default.
Parameters
label
string? The label to print out on lines. Recommend not to use spaces.
Examples
// Each log line can have it's own label / tag. const myFuncLog = 'MyFunc';const yourMethodLog = 'Yours'; myFuncLog;yourMethodLog;yourMethodLog; // Output:// stdout: 2017-03-10T09:44:06.391Z info MyFunc: My first info.// stderr: 2017-03-10T09:44:06.396Z warn Yours: {"obj":"a"}// stderr: 2017-03-10T09:44:06.394Z error Yours: My first err.
setOutput
By default the error
and warn
levels log output to console.error
, while all other
levels log output to console.log
.
Parameters
output
Object An object with 'log' and 'error' functions.
Examples
log;
- Throws Error
setFormatFunction
Override the default format function. Must supply a function to handle the following parameters (date, level, fnLabel, ...msgArgs).
Parameters
newFormatFunction
Function The new function to do the formatting of the output.
Examples
log;log; // Output:// stdout: INFO 1489198884388 Another info line.
- Throws Error
setLevel
Set the log level of the logger. Anything equal to or below this level
will be output. The default level is info
. The available log levels are:
- error
- warn
- info
- verbose
- debug
- silly
Parameters
newLogLevel
number The new level.
Examples
log; log;log;log;log; // Output:// stderr: 2017-03-10T09:44:06.394Z error: My second error line.
- Throws Error
Set debug log level from console
From the terminal:
DEBUG=MyFunction node app.js
Note: you can also use the following to enable debugging for all output:
DEBUG=* node app.js
// app.js const myFuncLog = 'MyFunc';const yourMethodLog = 'Yours'; myFuncLog;yourMethodLog; // Output:// stdout: 2017-03-10T09:44:06.391Z info MyFunc: My debug message.