babel-compat

library0.22.4jsnpmunverified

Custom Babel helpers for compatibility with older environments. Version 0.22.4, actively maintained. Provides thin wrappers around core Babel utilities for safer transpilation. Use alongside @babel/preset-env for targeted polyfilling. Differentiator: minimal overhead and explicit compat targets.

web-framework

npm install babel-compat

package ↗

INSTALL

IMPORT

SIG · BABEL-COMPAT

babel-compat

web-frameworkjavascriptv0.22.4

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.

babelCompatPlugin

✓ import { babelCompatPlugin } from 'babel-compat'

✗ const babelCompatPlugin = require('babel-compat').babelCompatPlugin

ESM-only since v0.20, no CommonJS support

default

✓ import babelCompat from 'babel-compat'

✗ const babelCompat = require('babel-compat')

Default export is ESM-only; requires bundler or Node.js --experimental-modules

CompatTarget

✓ import { CompatTarget } from 'babel-compat'

✗ import { CompatTarget } from 'babel-compat/types'

Type is exported from main entry, do not import from 'types' subpath

Basic Babel config using babel-compat plugin with IE11 target.

import { babelCompatPlugin } from 'babel-compat'; export default { plugins: [ [babelCompatPlugin, { target: 'ie11' }] ] };

Debug

Known issues

breakingESM-only since v0.20; CommonJS require() no longer works.

fix

Use import syntax or upgrade to Node.js v14+ with --experimental-modules.

affects: >=0.20

deprecatedOption 'target' is deprecated in v0.22; use 'compatTargets' array instead.

fix

Replace target: 'ie11' with compatTargets: ['ie11'].

affects: >=0.22

gotchaPlugin order matters: must be placed after @babel/preset-env to override helpers correctly.

fix

Ensure babel-compat plugin appears after @babel/preset-env in plugins array.

affects: >=0.18

gotchaDoes not automatically polyfill; only rewrites helper calls. Use with core-js for full polyfills.

fix

Add useBuiltIns: 'usage' and corejs: 3 in @babel/preset-env options.

affects: >=0.1

deprecatedThe 'include' option for selective helpers is deprecated since v0.22; use 'exclude' instead.

fix

Replace include: ['es6.object.assign'] with exclude: ['es6.object.assign'] (note inversion).

affects: >=0.22

Errors

Common errors & fixes

Cannot find module 'babel-compat'

Missing dependency or installed via npm with wrong registry.

fix

npm install babel-compat@0.22.4 --save-dev

TypeError: babelCompatPlugin is not a function

Using CommonJS require() which is not supported since v0.20.

fix

Switch to ESM import syntax: import { babelCompatPlugin } from 'babel-compat'

Error: Plugin babel-compat: 'target' option is deprecated, use 'compatTargets'

Using deprecated 'target' option in v0.22+.

fix

Replace target: 'ie11' with compatTargets: ['ie11']

Error: Unknown option 'include' for babel-compat

Using deprecated 'include' option in v0.22+.

fix

Replace include with exclude (option inverted).

Upgrade

Version history

0.22.4latest on npm

Audit

Dependencies

@babel/corerequiredCore Babel dependency for transpilation

@babel/preset-envoptionalRecommended preset for environment targeting

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/babel-compat ↗