Registry / devops / babel-plugin-inline-constants

babel-plugin-inline-constants

library5.0.0jsnpmunverified

Babel plugin (v5.0.0) to inline constant values from imported modules. Supports ESM (import) and CJS (require). Evaluates specified modules with Node to retrieve primitive values (numbers, strings, booleans, null) and replaces references directly in code for better gzip compression. TypeScript types included, ESM-only, Node 18+. Similar to babel-plugin-transform-define but focuses on module-exported constants.

devops serialization

npm install babel-plugin-inline-constants

github ↗package ↗

INSTALL

IMPORT

SIG · BABEL-PLUGIN-INLIN

babel-plugin-inline-constants

devopsjavascriptv5.0.0

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

✓ import inlineConstants from 'babel-plugin-inline-constants'

✗ const inlineConstants = require('babel-plugin-inline-constants')

ESM-only since v2. CommonJS require is invalid.

Options

✓ import type { Options } from 'babel-plugin-inline-constants'

TypeScript type import, not available as runtime value.

.babelrc plugin config

✓ { "plugins": [["babel-plugin-inline-constants", { "modules": "./constants.js" }]] }

✗ { "plugins": ["babel-plugin-inline-constants"] }

The modules option is required. Omitting it will cause an error.

Shows how to configure the plugin with a modules list, and how constants are inlined in the output.

// .babelrc { "plugins": [["babel-plugin-inline-constants", { "modules": ["./constants.js"] }]] } // constants.js export const SITE = 'example.com'; export const PORT = 8080; // input.js import { SITE, PORT } from './constants.js'; console.log(`https://${SITE}:${PORT}`); // output (after babel) console.log(`https://example.com:8080`);

Debug

Known issues

breakingDropped support for Node 16.

fix

Upgrade to Node 18+.

affects: >=5.0.0 <5.0.0

breakingMigration to ESM-only. No CommonJS support.

fix

Use import syntax or dynamic import().

affects: >=2.0.0

gotchaModules are evaluated with Node, so only use the plugin if you trust the code.

fix

Do not inline untrusted modules.

affects: >=0.0.0

gotchaThe modules option is required; omitting it throws an error.

fix

Always specify modules in plugin options.

affects: >=0.0.0

gotchaOnly primitives (numbers, strings, booleans, null) are inlined. Objects, arrays, functions are not supported.

fix

Ensure constants are primitives.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'babel-plugin-inline-constants'

Package not installed or installed as devDependency incorrectly.

fix

Run: npm install --save-dev babel-plugin-inline-constants

TypeError: inlineConstants is not a function

Using require on ESM-only module.

fix

Use import or ensure you are in an ESM context.

Error: babel-plugin-inline-constants: missing required option 'modules'

No modules option provided to the plugin.

fix

Example: { "plugins": [["babel-plugin-inline-constants", { "modules": ["./constants.js"] }]] }

Error: Cannot read properties of undefined (reading 'some')

Trying to inline a non-primitive export like an object or function.

fix

Only export primitives (numbers, strings, booleans, null) from constant modules.

Module not found: Can't resolve './my-constants'

Path resolution issue; module path relative to cwd.

fix

Ensure module path is correct relative to the Babel working directory.

Upgrade

Version history

5.0.0latest on npm

Audit

Dependencies

babelrequiredpeer dependency

Agent activity

17 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/wooorm/babel-plugin-inline-constants ↗

packagehttps://www.npmjs.com/package/babel-plugin-inline-constants ↗