Registry / devops / babel-plugin-alias-modules

babel-plugin-alias-modules

library2.32.2jsnpmunverified

A Babel plugin that rewrites aliased require() calls based on fields in package.json, such as the 'browser' field. Version 2.32.2 is current, maintained as part of the Liferay npm bundler toolkit. It enables module aliasing like webpack's resolve.aliasFields, scanning package.json for alias fields and redirecting require() calls. It only handles the local redirection part; external aliasing is handled by a companion plugin. Useful for isomorphic packages and browser polyfills.

devops

npm install babel-plugin-alias-modules

github ↗package ↗

INSTALL

IMPORT

SIG · BABEL-PLUGIN-ALIAS

babel-plugin-alias-modules

devopsjavascriptv2.32.2

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 babelPluginAliasModules from 'babel-plugin-alias-modules'

✗ const babelPluginAliasModules = require('babel-plugin-alias-modules')

CommonJS require works but ESM is preferred in modern Babel configs.

Config

✓ import type { Config } from 'babel-plugin-alias-modules'

TypeScript type import; not available in older versions.

createVisitor

✓ import { createVisitor } from 'babel-plugin-alias-modules'

Internal helper, not part of public API.

Basic Babel plugin configuration to alias modules using the 'browser' field from package.json.

// .babelrc.js const aliasModules = require('babel-plugin-alias-modules'); module.exports = { plugins: [ [aliasModules, { resolve: { aliasFields: ['browser'] } }] ] };

Debug

Known issues

breakingThe default value for resolve.aliasFields was changed to ['browser'], dropping 'unpkg' and 'jsdelivr' support due to issues.

fix

Explicitly set resolve.aliasFields to include 'unpkg' or 'jsdelivr' if needed.

affects: >=1.0.0

deprecatedUsing global config .npmbundlerrc is deprecated; use plugin options directly.

fix

Move configuration from .npmbundlerrc to Babel plugin options.

affects: >=2.0.0

gotchaThis plugin only redirects require() calls; external aliasing requires companion plugin liferay-npm-bundler-plugin-replace-browser-modules.

fix

Include the companion plugin for full alias functionality.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'babel-plugin-alias-modules'

Plugin not installed or missing from node_modules.

fix

Run npm install babel-plugin-alias-modules --save-dev

TypeError: [BABEL] unknown: Plugin is not a function or object

Incorrect plugin import syntax in Babel config.

fix

Use require('babel-plugin-alias-modules') (CommonJS) or default import.

Upgrade

Version history

2.32.2latest on npm

Audit

Dependencies

babel-coreoptionalPeer dependency for Babel plugin API

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/liferay/liferay-frontend-projects ↗

packagehttps://www.npmjs.com/package/babel-plugin-alias-modules ↗