WebPack Module

这些选项决定了如何处理项目中的不同类型的模块。

module.noParse

RegExp | [RegExp]

RegExp | [RegExp] | function（从 webpack 3.0.0 开始）

防止 webpack 解析那些任何与给定正则表达式相匹配的。忽略的中不应该含有 import, require, define 的，或任何其他导入机制。忽略大型的 library 可以提高构建。

noParse: /jquery|lodash/

// 从 webpack 3.0.0 开始
noParse: function(content) {
  return /jquery|lodash/.test(content);
}

module.rules

array

创建模块时，匹配请求的规则数组。这些规则能够模块的创建方式。这些规则能够对模块(module)应用 loader，或者解析器(parser)。

Rule

每个规则可以分为三部分 - 条件(condition)，结果(result)和嵌套规则(nested rule)。

Rule 条件

条件有两种输入值：

resource：请求的。它已经根据 resolve 规则解析。

issuer: 被请求资源(requested the resource)的模块的。是导入时的位置。

例如: 从 app.js 导入 './style.css'，resource 是 /path/to/style.css. issuer 是 /path/to/app.js。

在规则中， test, include, exclude 和 resource 对 resource 匹配，并且 issuer 对 issuer 匹配。

当使用多个条件时，所有条件都匹配。

小心！resource 是的_解析路径，这意味着符号的资源是真正的路径，而不是_符号位置。在使用工具来符号包的时候（如 npm link）比较好记，像 /node_modules/ 等常见条件可能会不小心错过符号的。注意，可以通过 resolve.symlinks 符号解析（以便将资源解析为符号路径）。

Rule 结果

规则结果只在规则条件匹配时使用。

规则有两种输入值：

应用的 loader：应用在 resource 上的 loader 数组。

Parser 选项：用于为模块创建解析器的选项对象。

这些会影响 loader：loader, options, use。

也兼容这些：query, loaders。

enforce 会影响 loader 种类。不论是普通的，前置的，后置的 loader。

parser 会影响 parser 选项。

嵌套的 Rule

可以使用 rules 和 oneOf 指定嵌套规则。

这些规则用于在规则条件(rule condition)匹配时进行取值。

Rule.enforce

可能的值有："pre" | "post"

指定 loader 种类。没有值表示是普通 loader。

还有额外的种类"行内 loader"，loader 被应用在 import/require 行内。

所有 loader 通过 前置, 行内, 普通, 后置 排序，并按此顺序使用。

所有普通 loader 可以通过在请求中 ! 前缀来忽略（覆盖）。

所有普通和前置 loader 可以通过在请求中 -! 前缀来忽略（覆盖）。

所有普通，后置和前置 loader 可以通过在请求中 !! 前缀来忽略（覆盖）。

不应该使用行内 loader 和 ! 前缀，因为它们是非标准的。它们可在由 loader 的中使用。

Rule.exclude

Rule.exclude 是 Rule.resource.exclude 的简写。如果你提供了 Rule.exclude 选项，就不能再提供 Rule.resource。详细请查看 Rule.resource 和 Condition.exclude。

Rule.include

Rule.include 是 Rule.resource.include 的简写。如果你提供了 Rule.include 选项，就不能再提供 Rule.resource。详细请查看 Rule.resource 和 Condition.include。

Rule.issuer

条件，用来与被发布的 request 对应的模块项匹配。在以下示例中，a.js request 的发布者(issuer)是 index.js 的路径。

index.js

import A from './a.js'

这个选项可以用来将 loader 应用到特定模块或一组模块的依赖中。

Rule.loader

Rule.loader 是 Rule.use: [ { loader } ] 的简写。详细请查看 Rule.use 和 UseEntry.loader。

Rule.loaders

由于需要 Rule.use，此选项已废弃。

Rule.loaders 是 Rule.use 的别名。详细请查看 Rule.use。

Rule.oneOf

规则数组，当规则匹配时，只使用第匹配规则。

{
  test: /.css$/,
  oneOf: [
    {
      resourceQuery: /inline/, // foo.css?inline
      use: 'url-loader'
    },
    {
      resourceQuery: /external/, // foo.css?external
      use: 'file-loader'
    }
  ]}

Rule.options / Rule.query

Rule.options 和 Rule.query 是 Rule.use: [ { options } ] 的简写。详细请查看 Rule.use 和 UseEntry.options。

由于需要 Rule.options 和 UseEntry.options，Rule.use，Rule.query 已废弃。

Rule.parser

解析选项对象。所有应用的解析选项都将合并。

解析器(parser)可以查阅这些选项，并相应地禁用或重新配置。大多数认，会如下解释值：

将选项设置为 false，将禁用解析器。

将选项设置为 true，或不将其保留为 undefined，可以启用解析器。

然而，一些解析器(parser)可能不光只接收布尔值。例如，内部的 NodeStuffPlugin 差距，可以接收对象，而不是 true，来为特定的规则额外的选项。

示例（认的解析器选项）：

parser: {
  amd: false, // 禁用 AMD
  commonjs: false, // 禁用 CommonJS
  sy: false, // 禁用 SyJS
  harmony: false, // 禁用 ES2015 Harmony import/export
  requireInclude: false, // 禁用 require.include
  requireEnsure: false, // 禁用 require.ensure
  requireContext: false, // 禁用 require.context
  browserify: false, // 禁用特殊处理的 browserify bundle
  requireJs: false, // 禁用 requirejs.*
  node: false, // 禁用 __dirname, __filename, module, require.extensions, require.main 等。
  node: {...} // 在模块级别(module level)上重新配置 node 层(layer)
  }

Rule.resource

条件会匹配 resource。既可以提供 Rule.resource 选项，也可以使用快捷选项 Rule.test，Rule.exclude 和 Rule.include。在 Rule 条件 中查看详细。

Rule.resourceQuery

A Condition matched with the resource query. This option is used to test against the query section of a request string (i.e. from the question mark onwards). If you were to import Foo from './foo.css?inline', the following condition would match:

{
  test: /.css$/,
  resourceQuery: /inline/,
  use: 'url-loader'}

Rule.rules

规则数组，当规则匹配时使用。

Rule.test

Rule.test 是 Rule.resource.test 的简写。如果你提供了 Rule.test 选项，就不能再提供 Rule.resource。详细请查看 Rule.resource 和 Condition.test。

Rule.use

应用于模块的 UseEntries 列表。每个入口(entry)指定使用 loader。

传递字符串（如：use: [ "style-loader" ]）是 loader 的简写方式（如：use: [ { loader: "style-loader "} ]）。

Loaders can be chained by passing multiple loaders, which will be applied from right to left (last to first conured).

use: [
  'style-loader',
  {
    loader: 'loader',
    options: {
      importLoaders: 1
    }
  },
  {
    loader: 'less-loader',
    options: {
      noIeCompat: true
    }
  }]

详细请查看 UseEntry。

条件

条件可以是这些之一：

字符串：匹配输入必须以提供的字符串开始。是的。目录或。

正则表达式：test 输入值。

：输入的，必须返回真值(truthy value)以匹配。

条件数组：至少匹配条件。

对象：匹配所有。每个都有定义行为。

{ test: Condition }：匹配特定条件。一般是提供正则表达式或正则表达式的数组，但这不是强制的。

{ include: Condition }：匹配特定条件。一般是提供字符串或者字符串数组，但这不是强制的。

{ exclude: Condition }：排除特定条件。一般是提供字符串或字符串数组，但这不是强制的。

{ and: [Condition] }：必须匹配数组中的所有条件

{ or: [Condition] }：匹配数组中任何条件

{ not: [Condition] }：必须排除这个条件

示例:

{
  test: /\.css$/,
  include: [
    path.resolve(__dirname, "app/styles"),
    path.resolve(__dirname, "vendor/styles")
  ]}

UseEntry

object

必须有 loader 是字符串。它使用 loader 解析选项（resolveLoader），相对于配置中的 context 来解析。

可以有 options 为字符串或对象。值可以传递到 loader 中，将其理解为 loader 选项。

由于兼容性原因，也可能有 query ，它是 options 的别名。使用 options 替代。

Example:

{
  loader: "loader",
  options: {
    modules: true
  }}

注意，webpack 需要资源和所有 loader 的独立模块标识，选项。它尝试对选项对象使用 JSON.stringify。这在 99.9% 的情况下是可以的，但是如果将相同的 loader 应用于相同资源的不同选项，并且选项具有一些带字符的值，则可能不是唯一的。

如果选项对象不被字符化（例如循环 JSON），它也会中断。因此，你可以在选项对象使用 ident ，作为唯一标识符。

模块上下文

Avoid using these options as they are deprecated and will soon be removed. 避免使用这些选项，因为它们已废弃，并将很快。

这些选项描述了当遇到动态依赖时，创建上下文的认设置。

例如，未知的(unkn) 动态依赖：require。

例如，表达式(expr) 动态依赖：require(expr)。

例如，包裹的(wrapped) 动态依赖：require("./templates/" + expr)。

以下是其的可用选项

module: {
  exprContextCritical: true,
  exprContextRecursive: true,
  exprContextRegExp: false,
  exprContextRequest: ".",
  unknContextCritical: true,
  unknContextRecursive: true,
  unknContextRegExp: false,
  unknContextRequest: ".",
  wrappedContextCritical: false
  wrappedContextRecursive: true,
  wrappedContextRegExp: /.*/,
  strictExportPresence: false // since webpack 2.3.0
  }

你可以使用 ContextReplacementPlugin 来这些单个依赖的值。这也会警告。

几个用例：

动态依赖的警告：wrappedContextCritical: true。

require(expr) 应该包含整个目录：exprContextRegExp: /^\.\//

require("./templates/" + expr) 不应该包含认子目录：wrappedContextRecursive: false

strictExportPresence makes missing exports an error instead of warning