首页 > 代码库 > webpack1.x 升级到 webpack2.x 英文文档翻译

webpack1.x 升级到 webpack2.x 英文文档翻译

近日项目要升级到webpack2.2,原来使用的webpack版本是1.12,在升级项目的同时,翻译一下官方的升级文档,去掉了一些不常用的配置.

 

resolve.rootresolve.fallback,resolve.modulesDirectories, ,这三个选项现在全部合并到resolve.modules一个选项中。关于resolving,查看更多  技术分享

resolve.extensions

这个配置项不再强制要求传入一个空字符串,这个行为被移动到了resolve.enforceExtension配置项

resolve.*

更多不常用的配置项不再一一列出来,详情请查看 resolving,查看更多。

module.loaders 现在转换为 module.rules

 功能更强大的rules系统取代了老版本中的loader,但是老的moduler.loader写法依然是被支持的,新的命名规则更加通俗易懂,非常建议使用新的module.rules。

 

技术分享

链式loaders

webpack1.x类似,链式loaders继续支持链式写法,匹配到的文件可以从一个loader传递到下一个loader,在新的rule.use配置项中,可以通过use项来指定需要用到的loader列表,在webpack1.x中需要用来分割不同的loader,新版本只在module.loader中支持这种写法。

技术分享

现在在配置loader的时候不允许省略-loader扩展名,例如:style-loader不可以简写为style

技术分享

如果你想继续使用省略-loader的写法,你可以在resolveLoader.moduleExtensions配置省略的-loader,不过不建议这么做

技术分享

json-loader不再是必须的,无需再单独安装

在没有为json文件配置loader的时候,webpack会默认自动使用json-loader来加载json文件

技术分享

在 webpack 1 中,loader 默认配置下 resolve 相对于被匹配的文件。而在 webpack 2 中默认配置的 resolve 相对于 context 配置项。

这解决了一些问题,比如使用 npm link 或引用 context 之外的模块时导致重复载入。

技术分享

移除了module.preloadersmodule.postLoaders

技术分享

 

UglifyJsPlugin sourceMap

UglifyJsPlugin 的 sourceMap 配置项现在默认为 false 而不是 true

这意味着如果你在压缩代码时启用了 source map,或者想要让 uglifyjs 的警告能够对应到正确的代码行,你需要将 UglifyJsPlugin 的 sourceMap 设为 true

 技术分享

UglifyJsPlugin warnings 

UglifyJsPlugin 的 compress.warnings 配置项现在默认为 false 而不是 true

这意味着如果你想要看到 uglifyjs 的警告信息,你需要将 compress.warnings 设为 true

技术分享

UglifyJsPlugin minimize loaders

UglifyJsPlugin 不再压缩 loaders。在未来很长一段时间里,需要通过设置 minimize:true 来压缩 loaders。参考 loader 文档里的相关配置项。

loaders 的压缩模式将在 webpack 3 或更高的版本中被取消。

为了兼容旧的 loaders,loaders 可以通过插件来切换到压缩模式:

技术分享

DedupePlugin 现在是被默认加载的

从你的配置文件中移除webpack.optimize.DedupePlugin 

BannerPlugin 大变化

BannerPlugin不再接收两个参数,取而代之的是一个对象

技术分享

OccurrenceOrderPlugin 不再需要手动加入,现在是默认的

 技术分享

ExtractTextWebpackPlugin 大变化

ExtractTextPlugin 1.0.0 不能在 webpack v2 下工作。 你需要安装ExtractTextPlugin v2。

npm install --save-dev extract-text-webpack-plugin@beta

新的ExtractTextPlugin插件的配置也发生了大变化

技术分享

技术分享

require.ensure和 AMD require 是异步的

现在这些函数总是异步的,而不是当 chunk 已经加载过的时候同步调用它们的 callback。

注意 require.ensure 现在依赖于原生的 Promise。如果在不支持 Promise 的环境里使用 require.ensure,你需要添加 polyfill

使用options来配置loader

webpack.config.js中将不再允许使用自定义属性来配置loder,例如:在ts配置项中的自定义属性将无法在被在webpack2中正确使用:

技术分享

options是什么?

严格来说,有两种办法,都可以用来配置 webpack 的 loader。典型的 options 被称为 query,是一个可以被添加到 loader 名之后的字符串。它比较像一个 query string,但是实际上有更强大的能力:

技术分享

不过它也可以分开来,写成一个单独的对象,紧跟在 loader 属性后面:

技术分享

LoaderOptionsPlugin context

有的 loader 需要从配置中读取一些 context 信息。在未来很长一段时间里,这将需要通过 loader options 传入。详见 loader 文档的相关选项。

为了保持对旧 loaders 的兼容,这些信息可以通过插件传进来:

技术分享

debug

在 webpack 1 中 debug 配置项切换 loaders 到 debug 模式。在将来很长一段时间里,这将需要通过 loader 配置项传递。详见 loader 文档的相关选项。

loaders 的 debug 模式将在 webpack 3 或后续版本中取消。

为了保持对旧 loaders 的兼容,loader 可以通过插件来切换到 debug 模式。

 技术分享

ES6代码分割

在 webpack v1 中,你能使用 require.ensure 作为方法来懒加载 chunks 到你的应用中:

技术分享

ES2015 模块加载规范定义了 import() 方法来运行时动态地加载 ES2015 模块。

webpack 将 import() 作为分割点并将被请求的模块放到一个单独的 chunk 中。

import() 接收模块名作为参数,并返回一个 Promise。

技术分享

好处是:如果加载 chunk 失败,我们可以进行处理,因为现在它基于 Promise

警告:require.ensure 允许用可选的第三个参数为 chunk 简单命名,但是 import API 还未提供这个功能。如果你想要保留这个功能,你可以继续使用 require.ensure

技术分享

动态表达式

可以传递部分表达式给 import()。这与 CommonJS 对表达式的处理方式一致(webpack 为所有可能匹配的文件创建 context)。

import() 为每一个可能的模块创建独立的 chunk。

技术分享

混合使用es6、AMD、CommonJS

你可以自由混合使用三种模块类型(甚至在同一个文件中)。在这个情况中 webpack 的行为和 babel 以及 node-eps 一致:

技术分享

但是请注意,不能让babe解析这些模块,从而让 webpack 可以使用它们。你可以通过设置如下配置到 .babelrc 或 babel-loader 来实现这一点。

技术分享

Hints

模板字符串

webpack 现在支持表达式中的模板字符串了。现在你可以这样使用:

技术分享

配置中使用 Promise

webpack 现在支持在配置文件中返回 Promise 了。这让你能在配置文件中做异步处理。

技术分享

高级 loader 匹配

ebpack 现在支持对 loader 进行更多方式的匹配。

技术分享

 

webpack1.x 升级到 webpack2.x 英文文档翻译