在线文档教程

依赖关系管理 | Dependency Management

Dependency Management

es6 modules commonjs amd

如果你的 request 含有表达式(expressions),会创建一个上下文(context),因为在编译时(compile time)并不清楚具体是哪一个模块被导入。

例:

require("./template/" + name + ".ejs"

webpack解析require()通话并提取一些信息:

Directory: ./template Regular expression: /^.*\.ejs$/

上下文模块

(译者注:这里的 request 应该是指在 require() 语句中的表达式,如 "./template/" + name + ".ejs")生成一个具有上下文的模块。它包含目录下的所有模块的引用(reference),这些模块能够「通过从 request 匹配出来的正则表达式」所 require 进来。上下文模块包含一个 map 对象,会把 request 中所有模块转译成对应的模块 id。

例:

{ "./table.ejs": 42, "./table-row.ejs": 43, "./directory/folder.ejs": 44 }

上下文模块还包含一些运行时(runtime)逻辑来访问这个 map 对象。

这意味着 webpack 能够支持动态 require,但会导致所有可能用到的模块都包含在 bundle 中。

require.context

你还可以使用 require.context() 方法来创建自己的(模块)上下文。

你可以给这个方法传 3 个参数:要搜索的文件夹目录,是否还应该搜索它的子目录,以及一个匹配文件的正则表达式。

webpack 会在构建的时候解析代码中的 require.context()

语法如下:

require.context(directory, useSubdirectories = false, regExp = /^\.\//)

例子:

require.context("./test", false, /\.test\.js$/ // a context with files from the test directory that can be required with a request endings with `.test.js`.

require.context("../", true, /\.stories\.js$/ // a context with all files in the parent folder and descending folders ending with `.stories.js`.

传递给 require.context 的参数必须是字面量(literal)!

上下文模块API

一个上下文模块导出一个(require)函数,这个函数可以接收一个参数:request。

导出的方法有 3 个属性: resolve, keys, id

  • resolve 是一个函数,它返回请求被解析后得到的模块 id。

  • keys 也是一个函数,它返回一个数组,由所有可能被上下文模块处理的请求(译者注:参考下面第二段代码中的 key)组成。

比如,如果想引入一个文件夹下面的所有文件,或者引入能匹配正则表达式的文件,你可以这样:

function importAll (r) { r.keys().forEach(r } importAll(require.context('../components/', true, /\.js$/)

var cache = {}; function importAll (r) { r.keys().forEach(key => cache[key] = r(key) } importAll(require.context('../components/', true, /\.js$/) // At build-time cache will be populated with all required modules.

  • id是上下文模块里面所包含的模块 id. 它可能在你使用 module.hot.accept 的时候被用到。