非常教程

Webpack参考手册

组态 | Configuration

其他选项 | Other Options

这些是webpack支持的其余配置选项。

寻求帮助:这个页面还在更新中,如果你发现本页面内有描述不准确或者不完整,请在 webpack 的文档仓库中创建 issue 或者 pull request

amd

object

设置require.amddefine.amd的值:

amd: {
  jQuery: true
}

某些流行的模块是按照 AMD 规范编写的,最引人瞩目的 jQuery 版本在 1.7.0 到 1.9.1,如果 loader 提示它对页面包含的多个版本采取了特殊许可时,才会注册为 AMD 模块。

许可权限是具有「限制指定版本注册」或「支持有不同定义模块的不同沙盒」的能力。

此选项允许将模块查找的键( key )设置为真值( truthy value )。 发生这种情况时,webpack 中的 AMD 支持将忽略定义的名称。

bail

boolean

在第一个错误出现时抛出失败结果,而不是容忍它。默认情况下,当使用 HMR 时,webpack 会将在终端以及浏览器控制台中,以红色文字记录这些错误,但仍然继续进行打包。要启用它:

bail: true

这将迫使 webpack 退出其打包过程。

cache

boolean object

缓存生成的 webpack 模块和 chunk,来改善构建速度。缓存默认在观察模式(watch mode)启用。禁用缓存只需简单传入:

cache: false

如果传递一个对象,webpack 将使用这个对象进行缓存。保持对此对象的引用,将可以在 compiler 调用之间共享同一缓存:

let SharedCache = {};

export default {
  ...,
  cache: SharedCache
}

不要在具有不同选项的呼叫之间共享缓存。详细说明警告和示例 - 使用不同的配置选项调用?

loader

object

将自定义值显示在加载器上下文中。

添加一个例子...

parallelism

number

限制并行处理模块的数量。可用于微调性能或获得更可靠的性能分析结果。

profile

boolean

捕获应用程序的“配置文件”,包括统计信息和提示,然后可以使用分析工具对其进行分析。

使用StatsPlugin可以更好地控制生成的配置文件。结合使用以parallelism: 1获得更好的结果。

recordsPath

开启这个选项可以生成一个 JSON 文件,其中含有 webpack 的 "records" 记录 - 即「用于存储跨多次构建(across multiple builds)的模块标识符」的数据片段。可以使用此文件来跟踪在每次构建之间的模块变化。只要简单的设置一下路径,就可以生成这个 JSON 文件:

recordsPath: path.join(__dirname, 'records.json')

如果你使用了代码分离(code splittnig)这样的复杂配置,records 会特别有用。这些数据用于确保拆分 bundle,以便实现你需要的缓存(caching)行为。

注意,虽然这个文件是由编译器(compiler)生成的,但你可能仍然希望在源代码管理中追踪它,以便随时记录它的变化情况。

设置 recordsPath 本质上会把 recordsInputPathrecordsOutputPath 都设置成相同的路径。通常来讲这也是符合逻辑的,除非你决定改变记录文件的名称。可以查看下面的实例:

recordsInputPath

指定读取最后一条记录的文件的名称。这可以用来重命名一个记录文件,可以查看下面的实例:

recordsOutputPath

指定记录要写入的位置。以下示例描述了如何用这个选项和 recordsInptuPaht 来重命名一个记录文件:

recordsInputPath: path.join(__dirname, 'records.json'),
recordsOutputPath: path.join(__dirname, 'newRecords.json')
Webpack

webpack 是一个模块打包器。webpack 处理带有依赖关系的模块,生成一系列表示这些模块的静态资源。

主页 https://webpack.js.org/
源码 https://github.com/webpack/webpack
发布版本 3.8.1

Webpack目录

1.指南 | Guides
2.接口 | API
3.概念 | Concepts
4.组态 | Configuration
5.装载 | Loaders