esbuild-minimizer-webpack-plugin

1.0.0-beta.2 verified Fri May 01 auth: no javascript

Webpack plugin that uses esbuild to minify JavaScript output, offering faster builds compared to TerserWebpackPlugin. Stable version 1.0.0-beta.2, developed with TypeScript, and integrates as a minimizer in webpack's optimization configuration. Key differentiators: leverages esbuild's speed, supports caching and parallel execution. Requires webpack ^4.0.0 as a peer dependency.

Common errors

error TypeError: ESBuildMinimizerPlugin is not a constructor ↓

cause Using named import instead of default import

fix

Use default import: import ESBuildMinimizerPlugin from 'esbuild-minimizer-webpack-plugin';

error Error: Cannot find module 'esbuild' ↓

cause Missing esbuild dependency

fix

Install esbuild: npm install --save-dev esbuild

error Error: webpack is not installed. ↓

cause Missing webpack peer dependency

fix

Install webpack: npm install --save-dev webpack@^4.0.0

Warnings

breaking Beta version may have breaking changes between releases ↓

fix Pin exact version or use a stable release when available.

deprecated require() usage may be deprecated in future versions ↓

fix Switch to ES import syntax: import ESBuildMinimizerPlugin from 'esbuild-minimizer-webpack-plugin';

gotcha The plugin only minifies JavaScript, not CSS or other assets ↓

fix Use additional plugins like css-minimizer-webpack-plugin for CSS.

Install

npm install esbuild-minimizer-webpack-plugin

yarn add esbuild-minimizer-webpack-plugin

pnpm add esbuild-minimizer-webpack-plugin

Imports

default

wrong

const ESBuildMinimizerPlugin = require('esbuild-minimizer-webpack-plugin')

correct

import ESBuildMinimizerPlugin from 'esbuild-minimizer-webpack-plugin'

The default export should be used; require() works but is not recommended.

ESBuildMinimizerPlugin

wrong

import { ESBuildMinimizerPlugin } from 'esbuild-minimizer-webpack-plugin'

correct

import ESBuildMinimizerPlugin from 'esbuild-minimizer-webpack-plugin'

This package exports a default class, not a named export.

ESBuildMinimizerPlugin (type)

wrong

import { ESBuildMinimizerPlugin } from 'esbuild-minimizer-webpack-plugin'

correct

import type ESBuildMinimizerPlugin from 'esbuild-minimizer-webpack-plugin'

For TypeScript, use 'import type' for type-only imports. Named export does not exist.

Quickstart

Demonstrates installing the plugin and adding it as a minimizer in webpack configuration with caching and parallelization enabled.

npm install --save-dev esbuild-minimizer-webpack-plugin

// webpack.config.js
import ESBuildMinimizerPlugin from 'esbuild-minimizer-webpack-plugin';

export default {
  optimization: {
    minimize: true,
    minimizer: [
      new ESBuildMinimizerPlugin({
        cache: true,
        parallel: true
      })
    ]
  }
};