Chunk Restriction Plugin

chunk-restriction-plugin

Help you monitor your chunk size.

Getting Started

To begin, you'll need to install chunk-restriction-plugin:

npm install --save-dev chunk-restriction-plugin

Then add the plugin to your webpack config. For example:

webpack.config.js

const ChunkRestrictionPlugin = require('chunk-restriction-plugin');

module.exports = {
	plugins: [
		new ChunkRestrictionPlugin({
			restrictions: [
				{
					chunkName: 'vendor',
					jsSize: '200 KiB',
					logType: 'warning'
				},
				{
					chunkName: 'app',
					jsSize: '150 KiB',
					cssSize: '100 KiB',
					logType: 'error'
				}
			]
		})
	]
};

Options

Name	Type	Required	Default	Description
restrictions	{Array}	true		Allows to define restriction on chunk's assets (js & css only)
defaultLogType	{String}	false	warning	Allows to define default treatment for all the restrictions specified.
logSafeChunks	{Boolean}	false	false	Allows to log information about chunks who are within the specified restriction.
safeSizeDifference	{String}	false		Allows to define difference between asset's size and its restriction, to be considered safe size. If specified, warns about chunks who does not meet this value.

restrictions

Type: Array Default: null

Allows to define restrictions on multiple chunks based on its chunk name.

Restriction object properties:

Property	Type	Description
chunkName	{String}	Allows to define chunk name
jsSize	{String}	Allows to define restriction on its JS asset. (in Bytes/KiB/MiB)
cssSize	{String}	Allows to define restriction on its CSS asset. (in Bytes/KiB/MiB)
logType	{String}	Allows to define severity of this restriction, overrides defaultLogType value. Possible values : "error" or "warning"

jsSize :

Used to set the limit on the chunk's js asset size.

Possible units:

• Byte/Bytes
• Kb/KiB
• Mb,MiB

cssSize :

Used to set the limit on the chunk's css asset size.

Possible units:

• Byte/Bytes
• Kb/KiB
• Mb,MiB

logType :

Allows to specify severity of this restriction. Overrides defaultLogType. Its default value gets set on the basis of defaultLogType option value.

Possible values :

• "error"
• "warning"

defaultLogType

Type: String Default: warning

Allows to define default treatment (either treat it as warning or error) for all the restrictions specified.

Possible values :

• "error"
• "warning"

logSafeChunks

Type: Boolean Default: false

Enable logging information about all the chunks who are within the defined restriction. Make sure stats.logging is set to log in your webpack configuration. (see stats logging for more details)

safeSizeDifference

Type: String Default: ""

Allows to define difference between asset's size and its restriction, which will be considered as safe size for all the chunks. If specified, warns about chunks who does not satisfy this condition. Useful when you want to get information about chunk's asset, whose size is about to meet its restriction.

Possible units:

• Byte/Bytes
• Kb/KiB
• Mb,MiB

License

MIT