Sponsor webpack and get apparel from the official shop or get stickers here! All proceeds go to our open collective!

ag-grid is proud to partner with webpack

CompressionWebpackPlugin

Prepare compressed versions of assets to serve them with Content-Encoding

Install

npm i -D compression-webpack-plugin

Usage

webpack.config.js

const CompressionPlugin = require("compression-webpack-plugin")

module.exports = {
  plugins: [
    new CompressionPlugin(...options)
  ]
}

Options

Name
Type
Default
Description
Name
Type
{RegExp|Array<RegExp>}
Default
.
Description
All assets matching this {RegExp|Array<RegExp>} are processed
Name
Type
{RegExp|Array<RegExp>}
Default
undefined
Description
Files to include
Name
Type
{RegExp|Array<RegExp>}
Default
undefined
Description
Files to exclude
Name
Type
{Boolean|String}
Default
false
Description
Enable file caching
Name
Type
{String}
Default
[path].gz[query]
Description
The target asset name. [file] is replaced with the original asset. [path] is replaced with the path of the original asset and [query] with the query
Name
Type
{Function}
Default
false
Description
A {Function} (asset) => asset which receives the asset name (after processing asset option) and returns the new asset name
Name
Type
{String|Function}
Default
gzip
Description
Can be (buffer, cb) => cb(buffer) or if a {String} is used the algorithm is taken from zlib
Name
Type
{Number}
Default
0
Description
Only assets bigger than this size are processed. In bytes.
Name
Type
{Number}
Default
0.8
Description
Only assets that compress better than this ratio are processed
Type
{Boolean}
Default
false
Description
Whether to delete the original assets or not

##

webpack.config.js

[
  new CompressionPlugin({
    test: /\.js/
  })
]

include

webpack.config.js

[
  new CompressionPlugin({
    include: /\/includes/
  })
]

exclude

webpack.config.js

[
  new CompressionPlugin({
    exclude: /\/excludes/
  })
]

cache

webpack.config.js

[
  new CompressionPlugin({
    cache: true
  })
]

asset

webpack.config.js

[
  new CompressionPlugin({
    asset: '[path].gz[query]'
  })
]

filename

webpack.config.js

[
  new CompressionPlugin({
    filename (asset) {
      asset = 'rename'
      return asset
    }
  })
]

algorithm

webpack.config.js

[
  new CompressionPlugin({
    algorithm: 'gzip'
  })
]

threshold

webpack.config.js

[
  new CompressionPlugin({
    threshold: 0
  })
]

minRatio

webpack.config.js

[
  new CompressionPlugin({
    minRatio: 0.8
  })
]

deleteOriginalAssets

webpack.config.js

[
  new CompressionPlugin({
    deleteOriginalAssets: true
  })
]

Maintainers


    Joshua Wiens


    Juho Vepsäläinen


    Michael Ciniawsky


    Alexander Krasnoyarov