Babel-plugin-undebug NPM

babel-plugin-undebug

Babel plugin to remove debug from code.

What is this?

This package is a Babel plugin to remove debug from code.

When should I use this?

This package is useful when debug is used to debug development code but can be stripped in production. An example is micromark, which is a complex state machine that can be plugged into with extensions but it’s also supposed to be small in browsers.

Install

This package is ESM only. In Node.js (version 12.20+, 14.14+, or 16.0+), install with npm:

npm install babel-plugin-undebug

In Deno with Skypack:

import {gemoji} from 'https://cdn.skypack.dev/babel-plugin-undebug@2?dts'

In browsers with Skypack:

<script type="module">
  import {gemoji} from 'https://cdn.skypack.dev/babel-plugin-undebug@2?min'
</script>

Use

example.js:

const debug = require('debug')('math')

let value = 1
debug('Value was %d', value)
value++
debug('Now we have %d', value)

Then (with @babel/cli and @babel/core installed):

babel example.js --plugins babel-plugin-undebug

Yields:

let value = 1;
value++;

API

This package exports no identifiers. The default export is babelPluginUndebug.

`babelPluginUndebug`

Plugin to remove debug from code. See its documentation on how to use Babel plugins.

Syntax tree

This package operates on the Babel (JavaScript) AST.

Looks for ESM (import) and CJS (require) loading 'debug'
Looks for code calling that function and assigning it, whether createDebug (const createDebug = require('debug'), d = createDebug('math')) or direct use (const d = require('debug')('math'))
Looks for calls of those assigned identifiers and remove whole debug calls, so side effects (d(value++)) will be dropped

Types

This package is fully typed with TypeScript. There are no extra exported types.

Compatibility

This package is at least compatible with all maintained versions of Node.js. As of now, that is Node.js 12.20+, 14.14+, and 16.0+. It also works in Deno and modern browsers.