1.0.0-rc12 • Published 6 years ago
ebug v1.0.0-rc12
ebug
A mini NodeJS debug module based on https://github.com/visionmedia/debug.
Optional Features
- Terminal coloring for namespace & timestamps.
- Real time timestamp of call to
ebug
or millisecond difference of timestamps between calls toebug
for the given namespace. - Optional global namespace prefix for messages.
- Custom string for spacing around namespaces in messages.
- Uses util.format internally, so all of the formatting there is available.
Usage
- Initialize with the debugging namespace of the module (which will be colorized in terminal output).
- Run with the DEBUG environment variable properly set for the given module, or multiple modules, to see output.
test.js
// Using default options
const debug = require('ebug')('test')
// With custom options
const debug = require('ebug')('test', {
namespacePrefix: '@',
realTime: true,
useISO: true,
useColors: false,
spacingString: '\t'
})
debug('Something something something...%s.', 'dark side')
terminal/command line
Output With Default Options (coloring added by markdown formatting for example effect)
DEBUG=test node test.js
test Something something something...dark side. +0ms
Output From Custom Options Above (coloring removed for example effect)
DEBUG=test node test.js
2018-08-17T10:17:50.411Z @test Something something something...dark side.
Using A Wildcard For process.env.DEBUG
(coloring added by markdown formatting for example effect)
DEBUG=test*,*test,*test* node test.js
test Something something something...dark side. +0ms
In the above example each of test*, *test, and *test* matches the namespace test.
Options
Name | Default | Explanation |
---|---|---|
namespacePrefix | '' | Prepended to namespaces in messages. |
realTime | false | Use real timestamps instead of millisecond difference. |
useISO | false | Use ISO timestamps instead of UTC. |
useColors | true | Use colors for terminal output. |
spacingString | ' ' | Custom spacing around namespace in messages. |
Note
Black (30) has been removed from the list of colors available for now. Will return with background coloring included in a future update, unless I can find some way to get the background color of the terminal..
1.0.0-rc12
6 years ago
1.0.0-rc11
6 years ago
1.0.0-rc10
6 years ago
1.0.0-rc9
6 years ago
1.0.0-rc8
6 years ago
1.0.0-rc7
6 years ago
1.0.0-rc6
6 years ago
1.0.0-rc5
6 years ago
1.0.0-rc4
6 years ago
1.0.0-rc3
6 years ago
1.0.0-rc2
6 years ago
1.0.0-rc1
6 years ago