A tiny debugging wrapper on top of debug
The main difference is that debug3 accepts functions as arguments and does not execute them unless it will output something (ie process.env.DEBUG is set to the relevant value).
This saves valuable processing resources that may have been used to create debug output that might not even be displayed.
Bonus: Package name of the calling module is prefixed to the debug message (can be turned off)
$ npm install debug3debug3 exposes a function; simply pass this function a namespace, and it will return a decorated version of console.error for you to pass debug statements to.
Pass this resulting function any type of object, including functions.
(In these examples package.json has a name of super-server which you can see in the output)
Basic Example
const debug = require('debug3')('http');
debug('This is a debug test!', [1, 2, 3]);
// Output: **super-server:http** This is a debug test! [1, 2, 3]Passing a function
const debug = require('debug3')('http');
// ES6
debug('This is a debug test!', () => [1, 2, 3]);
// Output: **super-server:http** This is a debug test! [1, 2, 3]
// ES5
debug('This is a debug test!', function() { return [1, 2, 3] });
// Output: **super-server:http** This is a debug test! [1, 2, 3]Turning off the package name prefix
const debug = require('debug3')('http', {prefix: false});
debug('This is a debug test!', [1, 2, 3]);
// Output: **http** This is a debug test! [1, 2, 3]Original debug
const debug = require('debug')('http');
debug('This is a debug test!', [1, 2, 3], JSON.stringify(largefile));
// With process.env.DEBUG === 'super-server:*'
// Output: **super-server:http** [1, 2, 3], {"large-json-file": [1111212,2232323,4435353....
// Time taken: 500ms
debug('This is a debug test!', [1, 2, 3], JSON.stringify(largefile));
// With process.env.DEBUG === undefined
// Output: <empty>
// Time taken: 500ms
^^^^^!!!!With debug3
const debug = require('debug3')('http');
debug([1, 2, 3], () => JSON.stringify(largefile));
// With process.env.DEBUG === 'super-server:*'
// Output: **super-server:http** [1, 2, 3], {"large-json-file": [1111212,2232323,4435353....
// Time taken: 500ms
debug([1, 2, 3], () => JSON.stringify(largefile));
// With process.env.DEBUG === undefined
// Output: <empty>
// Time taken: 0ms
^^^ thats more like it!Because debug2 was taken :)
MIT. See LICENSE file
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent