Package Exports

@superhero/debug

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@superhero/debug) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Debug

Licence: MIT

A debug utility for pretty log output..

Install

npm install @superhero/debug

...or just set the dependency in your package.json file:

{
  "dependencies":
  {
    "@superhero/debug": "*"
  }
}

Example

const
Debug = require('@superhero/debug'),
debug = new Debug(/* options */);

debug.log('what is this?', {foo:'bar', baz:'qux'});

// outputs something like the following in the console log (color coded):
/*
  2017-11-17 13:20:40:	what is this?	{ foo: 'bar',
    baz: 'qux' }
*/

Or the shorter version if you don't need to define any options:

require('@superhero/debug').log('what is this?', {foo:'bar', baz:'qux'});

Options

All options are optional.

{
  // cap array output
  maxArrayLength: 10,

  // cap object depth
  maxObjectDepth: 10,

  // cap string length
  maxStringLength: 100,

  // define a desired color of the output:
  // ['black', 'blue', 'cyan', 'green', 'magenta', 'red', 'yellow', 'white', false]
  color: undefined,

  // if false, output wont be colored.
  colors: true,

  // show timestamp in prefix.
  date: true,

  // available date formats @see: https://www.npmjs.com/package/dateformat
  dateFormat: 'yyyy-mm-dd HH:MM:ss',

  // if false, no output is made.
  debug: true,

  // if an auto increment index should be printed.
  index: false,

  // a static string that will prefix all output of this instance.
  prefix: false,

  // the separator to use between content.
  separator: '\t',

  // error output, writable stream
  stderr: process.stderr,

  // log output, writable stream
  stdout: process.stdout
}