Tiny debug tool (~600 bytes) for terminal and browser inspired by debug-js/debug API.

Forked from @wbe/debug, this was built in order to be as light as possible for terminal and browser, as the same way as the great debug-js/debug tool, with a few added debug-js/debug parity features. The package is less than 10k unpacked on disk, and published directly from Github with provenance.

$ npm i @localnerve/debug

DEBUG=* node file.js

file.js:

import debug from "@localnerve/debug"
const log = debug("namespace")
log("hello") // "namespace hello"

process.env.DEBUG value can be defined as a specific namespace too:

DEBUG=namespace-1 node file.js

Only debug function declaration with namespace-1 declared as namespace will be printed in the console:

import debug from "@localnerve/debug"
const log = debug("namespace-1")
log("hello") // "namespace-1 hello"

process.env.DEBUG value accept "one glob parameter level":

DEBUG=config:* node file.js

Every debug function declaration with namespace config:{somestring} will be logged.

In the same way as nodejs usage, debug is browser compatible with the same API. The only difference is we need to set the current namespace in localStorage.

Add on your browser localStorage:

localStorage.debug = "foo"

Use debug in javascript:

// es6 import
import debug from "@localnerve/debug"
const log = debug("foo")
log("bar") // "foo bar"

Install dependencies:

Start example:

# browser example
npm run dev:example-browser
# node example
npm run dev:example-dev

Willy Brauner

MIT