stdlogger

A simple isomorphic logger, that uses console transport.

Table of Contents

• stdlogger
  • Table of Contents
  • Requirements
  • Installation
  • Simple usage
  • Advanced usage
    • Configuration:
  • Contribute

Requirements

To use library you need to have node and npm installed in your machine:

• node >=10
• npm >=6

Package is continuously tested on darwin, linux and win32 platforms. All active and maintenance LTS node releases are supported.

Installation

To install the library run the following command

  npm i --save stdlogger

Simple usage

import logger from 'stdlogger';

logger.log('some text');

logger.log('debug', 'some debug text');
logger.log('verbose', 'some verbose text');
logger.log('info', 'some info text');
logger.log('error', 'some error text');

logger.debug('some debug text');
logger.verbose('some verbose text');
logger.info('some info text');
logger.error('some error text');

Advanced usage

import { Logger } from 'stdlogger';

const logger = new Logger({
    level  : 'info',
    format : 'json'
});

logger.log({ object: true });

Configuration:

The following options are suitable for Logger configuration:

• levels: An array with applicable logging levels. Default: ['debug', 'verbose', 'info', 'error']. If accessible by console[level], console[level] will be used; otherwise, console.log will be used.

• level: Threshold log level. All messages with log level < level will be ignored. Verbosity is obtained from the index in the levels array. Default: levels[0].

• console: Use a separate console:

import { Console } from 'console';
import { consoleConfig } from 'stdlogger';

const console = new Console(consoleConfig({
    colorMode : true
}));

const logger = new Logger({ console });

logger.log({ object: true });

• format: Select formatter. Possible options are simple and json. simple is selected by default.

Contribute

Make the changes to the code and tests. Then commit to your branch. Be sure to follow the commit message conventions. Read Contributing Guidelines for details.