Registry / devops / esbuild-plugin-ignore

esbuild-plugin-ignore

library1.1.1jsnpmunverified

esbuild-plugin-ignore (v1.1.1) is a plugin for esbuild that allows ignoring specific dependencies during bundling, similar to Webpack's IgnorePlugin. It provides a straightforward way to exclude modules based on regular expressions matching resource and context paths. The package supports both ESM and CommonJS, and is actively maintained. Key differentiators: simple API, no external dependencies, works with esbuild's plugin system. Version 1.1.1 is the latest stable release with no recent changes.

devops

npm install esbuild-plugin-ignore

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-IGN

esbuild-plugin-ignore

devopsjavascriptv1.1.1

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–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

ignorePlugin

✓ import { ignorePlugin } from 'esbuild-plugin-ignore'

✗ const ignorePlugin = require('esbuild-plugin-ignore')

Package supports both ESM and CommonJS; named import is correct for ESM. For CommonJS, use `const { ignorePlugin } = require('esbuild-plugin-ignore')`.

ignorePlugin (default import)

✓ import ignorePlugin from 'esbuild-plugin-ignore'

✗ import * as ignorePlugin from 'esbuild-plugin-ignore'

Default import is also valid and returns the same function as named import.

IgnorePlugin (commonjs)

✓ const { ignorePlugin } = require('esbuild-plugin-ignore')

✗ const ignorePlugin = require('esbuild-plugin-ignore').default

CommonJS users should destructure the require result; there is no .default property.

Configures esbuild with ignorePlugin to exclude certain modules (e.g., pg-native, tedious) from bundling using Webpack-like ignore rules.

import { ignorePlugin } from 'esbuild-plugin-ignore'; import * as esbuild from 'esbuild'; await esbuild.build({ entryPoints: ['src/index.js'], bundle: true, outfile: 'dist/bundle.js', plugins: [ ignorePlugin([ { resourceRegExp: /pg-native$/, contextRegExp: /node_modules\/sequelize|node_modules\/pg/ }, { resourceRegExp: /tedious|sqlite3|mariadb$/, contextRegExp: /node_modules\/sequelize/ } ]) ] });

Debug

Known issues

gotchaPlugin ignores modules based on RegExp; over-broad patterns may unintentionally exclude necessary dependencies.

fix

Use specific resourceRegExp and contextRegExp patterns matching only the modules you intend to ignore.

affects: >=1.0.0

gotchaPlugin does not check if ignored modules are actually required; may produce runtime errors if they are missing.

fix

Ensure ignored modules are not actually used in your code or provide polyfills as needed.

affects: >=1.0.0

gotchaThe plugin matches both resource and context; if contextRegExp is not specified, it defaults to '/.*/' matching any context.

fix

Explicitly define contextRegExp to avoid unintended matches.

affects: <=1.1.1

Errors

Common errors & fixes

Error: Build failed with 1 error: error: Could not resolve 'pg-native'

The module 'pg-native' is being required but esbuild cannot find it because it's not installed or is ignored incorrectly.

fix

Either install the missing dependency or add it to the ignorePlugin rule with correct resourceRegExp.

TypeError: ignorePlugin is not a function

Importing the plugin incorrectly: using default import when named import is expected, or vice versa.

fix

Use named import: `import { ignorePlugin } from 'esbuild-plugin-ignore'`

Cannot find module 'esbuild-plugin-ignore'

Package not installed or not in node_modules.

fix

Run `npm install esbuild-plugin-ignore` or `yarn add esbuild-plugin-ignore`.

Upgrade

Version history

1.1.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/Knowre-Dev/esbuild-plugin-ignore ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-ignore ↗