Skip to content
Adds file path and loc information to debug calls. Heavily inspired by babel-plugin-console-source
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
test
.gitignore
.travis.yml
LICENSE
Readme.md
index.js
package.json
renovate.json
yarn.lock

Readme.md

babel-plugin-debug-source

Adds file path and loc information for debug calls. Makes it easier to find the origin of the debug messages.

In:

const debug = require('debug')('my-app');
debug('hello');

Out:

const debug = require('debug')('my-app');
debug('hello', '/Users/your/project/path/source.js:2:0');

Installation

npm install -D babel-plugin-debug-source

Usage

.babelrc

{
  plugins: ['debug-source'];
}

Options

showSource: whether the plugin should run and add the source to debug calls. Defaults to true.

.babelrc

{
  plugins: [['debug-source', { showSource: true }]];
}

It probably makes sense to stay in the spirit of debug and only set showSource to true, when an environment variable is set.

e.g.

.babelrc

{
  plugins: [
    ['debug-source', { showSource: process.env.DEBUG_SHOW_SOURCE === 'true' }]
  ];
}

This is not the default behavior, because babel (or bundlers utilizing babel) use heavy caching. Changes in environment variables usually do not cause a cache invalidation and the result will unexpectedly stay the same.

You can’t perform that action at this time.