@idio/debug

@idio/debug is the fork of the popular debug package that was rewritten in modern JS using the ES6 modules, to be able to compile it with Closure Compiler. Currently, only the Node.JS version is supported.

yarn add @idio/debug

Table Of Contents

• Table Of Contents
• API
• debug(namespace: string): debugFunction
  • _debug.Env
  • _debug.DebugContext
  • _debug.DebugFunction
• Modifiers
• Copyright

API

The package is available by importing its default function:

import debug from '@idio/debug'

debug(
  namespace: string,
): debugFunction

Creates a debug function for the given namespace.

import debug from '@idio/debug'

const log = debug('example')
log('hello')
log('world')

example hello +0ms
  example world +4ms

Show Types

_debug.Env: An environment.

Name	Type	Description
init*	function(_debug.DebugFunction)	Env-specific initialization logic for debug instances.
log*	function(...*)	The logging function.
formatArgs*	function(this: _debug.DebugFunction, !Array)	Apply env-specific formatting (colors, etc.).
save*	!Function	Save namespaces.
load*	!Function	Load namespaces.
formatters*	Object<string, function(!Object): string>	Map of special "%n" handling functions, for the debug "format" argument. Valid key names are a single, lower or upper-case letter, i.e. "n" and "N".
useColors*	!Function	Is stdout a TTY? Colored output is enabled when true.
colors*	!Array<number>	The array of supported colors.
inspectOpts*	!Object<string, *>	The options from the env variables, e.g., DEBUG_COLORS=no DEBUG_DEPTH=10 DEBUG_SHOW_HIDDEN=enabled node script.js.

_debug.DebugContext

Name	Type	Description
namespace*	string	The namespace for which the debug function was setup.
enabled*	boolean	Whether the debug function is enabled.
useColors*	boolean	If the environment uses colors.
diff*	number	The diff between the prev time and current time.
prev*	number	The previous time.
curr*	number	The current time.
log	function(...*)	The manually set logging function that overrides the environment log function.
color*	(number | string)	The color for the namespace.
destroy*	function(this: _debug.DebugFunction): boolean	Removes the debug function from the namespace.
extend*	function(this: _debug.DebugFunction, string, string): _debug.DebugFunction	Using the debug function, creates a new one.

function(this:_debug.DebugContext, ...*) _debug.DebugFunction: The setup debug function.

Modifiers

The modifiers can be used to print information in formatted way.

Modifier	Action
%O	Multiline inspect.
%o	Single line inspect.
%f	File-size format of bytes, e.g., 10MB.
%fy	File-size in yellow.
%fr	File-size in red.
%fb	File-size in blue.
%fg	File-size in green.
%fc	File-size in cyan
%fm	File-size in magenta.

import Debug from '@idio/debug'

const debug = Debug('example')
debug('hello %O', { test: 'ok' })
debug('world %f', 105248)

example hello { test: 'ok' } +0ms
  example world 102.78KB +16ms

Copyright

Original Authors:

• TJ Holowaychuk
• Nathan Rajlich
• Andrew Rhyne

---

	© Art Deco for Idio 2019			Tech Nation Visa Sucks