Last Call Webpack Plugin
A Webpack plugin that allows you to transform \ modify assets just before Webpack emits them.
What does the plugin do?
It allows you to transform \ modify Webpack assets just before Webpack emits them (writes them to files or memory in case you are using something like Webpack dev server).
It can be used for example to:
- Prefix a
/* Author: John Doe */
comment on all the .js files Webpack generates. - Run some final optimization on all .css files Webpack generates.
Installation:
Using npm:
$ npm install --save-dev last-call-webpack-plugin
⚠️ For webpack v3 or below please use
last-call-webpack-plugin@v2.1.2
. Thelast-call-webpack-plugin@v3.0.0
version and above supports webpack v4.
Configuration:
The plugin can receive the following options:
- assetProcessors: An Array of objects that describe asset processors:
- regExp: A regular expression to match the asset name that the processor handles.
- processor: A function with the signature of
function(assetName, webpackAssetObject, assets)
that returns a Promise. If the Promise returns a result this result will replace the assets content. - phase: The webpack compilation phase that at which the processor should be called. Default value is
compilation.optimize-assets
. Can be one of the following values:compilation.optimize-chunk-assets
compilation.optimize-assets
emit
- canPrint: A boolean indicating if the plugin can print messages to the console, defaults to
true
.
Note: An environment supporting Promises or a Promise polyfill is needed for this plugin to be used.
Example:
var cssnano = ;var LastCallWebpackPlugin = ;moduleexports =module:loaders:test: /\.css$/ loader: ExtractTextPluginplugins:"styles.css"assetProcessors:regExp: /\.js$/PromiseregExp: /\.css$/cssnanocanPrint: true
Assets manipulation
The processor
method is supplied an assets
object that allows asset manipulation via the setAsset(assetName, assetValue)
method. If assetValue
is null the asset will be deleted. This object can be used to generate aditional assets (like source maps) or rename the an asset (create a new asset and delete the current one).
Example:
var cssnano = ;var LastCallWebpackPlugin = ;moduleexports =module:loaders:test: /\.css$/ loader: ExtractTextPluginplugins:"styles.css"assetProcessors:regExp: /\.css$/{assets; // Delete the <assetName>.map asset.assets; // Add the <assetName>.log asset with the content 'All OK'.return cssnano}canPrint: true
The assets
object also has a getAsset(assetName)
method to get the content of an asset (returns undefined in case the asset does not exist).
License
MIT (http://www.opensource.org/licenses/mit-license.php)