@rushstack/module-minifier-plugin

@rushstack/module-minifier-plugin

Installation

npm install @rushstack/module-minifier-plugin --save-dev

Overview

This Webpack plugin performs minification of production assets on a per-module basis, rather than minifying an entire chunk at a time. It issues async calls to the minifier for each unique module and each unique set of chunk boilerplate (i.e. the webpack runtime and the structure of the module list). This improves minification time by:

• Avoiding duplicate work for each module that is included in multiple distinct assets/chunks (this is common with async chunks)
• Handing smaller code chunks to the minifier at a time (AST analysis is superlinear in size of the AST)
• Even single asset builds will likely still contain multiple modules in the final output, which can be split across available CPU cores

Use with [hash] and [contenthash] tokens

The plugin will do its best to update webpack hashes if changing the direct inputs (useSourceMap, compressAsyncImports or usePortableModules) to the plugin, but if altering the minifier property itself, you may need to use the output.hashSalt property to force a change to the hashes, especially if leverging the MessagePortMinifier or similar, since it has no direct access to the configuration of the minifier.

Parallel execution

If running on node 10, you will need to ensure that the --experimental-workers flag is enabled.

const { ModuleMinifierPlugin, WorkerPoolMinifier } = require('@rushstack/module-minifier-plugin');

// In your webpack options:
optimization: {
  minimizer: [
    new ModuleMinifierPlugin({
      minifier: new WorkerPoolMinifier(),
      // If not provided, the plugin will attempt to guess from `mode` and `devtool`.
      // Providing it expressly gives better results
      useSourceMap: true
    })
  ]
}

Single-threaded execution

You can also run the ModuleMinifierPlugin in a single-threaded configuration.

// webpack.config.js
const { ModuleMinifierPlugin, LocalMinifier } = require('@rushstack/module-minifier-plugin');

// In your webpack options:
optimization: {
  minimizer: [
    new ModuleMinifierPlugin({
      minifier: new LocalMinifier()
    })
  ]
}

Links

• CHANGELOG.md - Find out what's new in the latest version

@rushstack/module-minifier-plugin is part of the Rush Stack family of projects.