Registry / devops / babel-plugin-conditional-compile

babel-plugin-conditional-compile

library0.0.5jsnpmunverified

A Babel plugin that performs conditional compilation by evaluating if statements with predefined constants and removing dead code. Version 0.0.5 is the latest stable release, updated infrequently (last release in 2016). It allows developers to define compile-time constants (e.g., IS_DEV, CODE_FOR_IE) and automatically eliminate unreachable branches during bundling, reducing bundle size. Unlike webpack's DefinePlugin or similar tools, this operates at the AST level within Babel transformation pipeline. Supports dropping debugger statements and arbitrary constant replacement. Lacks TypeScript definitions and ES module support; designed for legacy Babel 6.x.

devops

npm install babel-plugin-conditional-compile

github ↗package ↗

INSTALL

IMPORT

SIG · BABEL-PLUGIN-CONDI

babel-plugin-conditional-compile

devopsjavascriptv0.0.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ // No import needed - plugin is specified in Babel config

✗ import conditionalCompile from 'babel-plugin-conditional-compile'

This is a Babel plugin, not a module to import directly. Add it to plugins array in .babelrc or babel.transform options.

babel-core

✓ const babel = require('babel-core');

✗ import { transform } from 'babel/core'; // wrong because babel-core was the v6 package

This plugin targets Babel 6.x, where the package is 'babel-core' (not '@babel/core'). Use require('babel-core') for compatibility.

PluginConfig

✓ // Options are passed as second element in plugin array: plugins: [['conditional-compile', { define: { IS_DEV: true } }]]

✗ plugins: ['conditional-compile'] // no options object

Without passing an options object, no defines will be set and the plugin becomes a no-op.

Demonstrates using Babel 6 with the plugin to remove dead code based on compile-time constants. Sets IS_DEV to false and CODE_FOR_CHROME to true, removing the IE branch and debug log.

Debug

Known issues

deprecatedPackage is unmaintained since 2016 and only supports Babel 6.x (babel-core), not Babel 7+ (@babel/core).

fix

Use @babel/plugin-transform-conditional-compile or other modern alternatives.

affects: >=0.0.1

gotchaThe plugin does not support ES module syntax (import/export); works only with CommonJS require.

fix

Ensure your Babel preset is set to transform ES modules to CommonJS, or use a different plugin that supports ESM.

affects: >=0.0.0

breakingIncorrect use of 'require('babel-plugin-conditional-compile')' at runtime will fail because the plugin is not designed to be called directly.

fix

Do not attempt to require the plugin yourself. Instead, specify it in .babelrc or babel.transform plugins array as a string.

affects: >=0.0.0

gotchaOptions object must be provided as second array element; omitting it causes all defines to be undefined and no code removal occurs.

fix

Always pass an object with define property, even if empty: plugins: [['conditional-compile', {}]]

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'babel-core'

Attempting to use the plugin with Babel 7+ where '@babel/core' is the package name, not 'babel-core'.

fix

Install 'babel-core' (legacy): npm install babel-core@6 --save-dev, or migrate to a plugin compatible with @babel/core.

ReferenceError: IS_DEV is not defined

The plugin is not configured or is not transforming the code because the define option is missing or misspelled.

fix

Ensure the plugin is listed in .babelrc. Example: { plugins: [['conditional-compile', { define: { IS_DEV: true } }]] }

TypeError: Cannot read property 'visitor' of undefined

Plugin is not properly installed or is being used as a function instead of a string in Babel config.

fix

Reference the plugin by its package name string in the plugins array: ['conditional-compile', options]

Upgrade

Version history

0.0.5latest on npm

Audit

Dependencies

babel-corerequiredRequires Babel 6.x runtime to function as a plugin.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/brianZeng/babel-plugin-conditional-compile ↗

packagehttps://www.npmjs.com/package/babel-plugin-conditional-compile ↗