1. Performance(性能)
这些选项可以控制 webpack 如何通知「资源(asset)和入口起点超过指定文件限制」。 此功能受到webpack 性能评估的启发。
1.1. performance
类型:object
配置如何展示性能提示。例如,如果一个资源超过 250kb,webpack 会对此输出一个警告来通知你。
1.1.1. performance.hints
类型:false | "error" | "warning"
默认值: "warning"
打开/关闭提示。此外,当找到提示时,告诉 webpack 抛出一个错误或警告。此属性默认设置为"warning"
。
给定一个创建后超过 250kb 的资源:
performance: {
hints: false
}
上面的设置为false,不会展示警告或错误提示。
performance: {
hints: "warning"
}
将展示一条警告,通知你这是体积大的资源。在开发环境,我们推荐这样。
performance: {
hints: "error"
}
将展示一条错误,通知你这是体积大的资源。在生产环境构建时,我们推荐使用hints: "error"
,有助于防止把体积巨大的 bundle 部署到生产环境,从而影响网页的性能。
1.1.2. performance.maxEntryPointSize
类型:int
默认值是:250000
(bytes)
入口起点表示针对指定的入口,对于所有资源,要充分利用初始加载时(initial load time)期间。此选项根据入口起点的最大体积,控制 webpack 何时生成性能提示。
performance: {
maxEntrypointSize: 400000
}
1.1.3. performance.maxAssetSize
类型:int
默认值是:250000
(bytes)
资源(asset)是从 webpack 生成的任何文件。此选项根据单个资源体积,控制 webpack 何时生成性能提示。
performance: {
maxAssetSize: 100000
}
1.1.4. performance.assetFilter
类型:function
该属性允许webpack控制使用哪些文件来计算性能提示。也就是过滤资源。默认的函数如下:
function(assetFilename) {
return !(/\.map$/.test(assetFilename))
};
你可以通过传递自己的函数来覆盖此属性:
performance: {
assetFilter: function(assetFilename) {
return assetFilename.endsWith('.js');
}
}
以上示例将只给出.js
文件的性能提示。