webpack中的require.context

带表达式的require语句

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

示例：

require('./template/' + name + '.ejs');

webpack 解析 require() 调用，然后提取出如下一些信息：

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

context module

生成一个 contextmodule(上下文模块)。它包含目录下的所有模块的引用，是通过一个request解析出来的正则表达式，去匹配目录下所有符合的模块，然后都 require 进来。此 context module 包含一个 map 对象，会把 request 中所有模块翻译成对应的模块 id。

示例：

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

此 context module 还包含一些访问这个 map 对象的 runtime 逻辑。

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

require.context

你还可以通过 require.context() 函数来创建自己的context。

可以给这个函数传入三个参数：一个要搜索的目录，一个标记表示是否还搜索其子目录，以及一个匹配文件的正则表达式。

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

语法如下：

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

示例：

require.context('./test', false, /.test.js$/);
// （创建出）一个 context，其中文件来自 test 目录，request 以 `.test.js` 结尾。

require.context('../', true, /.stories.js$/);
// （创建出）一个 context，其中所有文件都来自父文件夹及其所有子级文件夹，request 以 `.stories.js` 结尾。

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

context module API

一个 context module会导出一个（require）函数，此函数可以接收一个参数：request。

此导出函数有三个属性：resolve, keys, id。

resolve 是一个函数，它返回 request 被解析后得到的模块 id。
keys 也是一个函数，它返回一个数组，由所有可能被此 context module 处理的请求（译者注：参考下面第二段代码中的 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$/));
// 在构建时(build-time)，所有被 require 的模块都会被填充到 cache 对象中。

id 是 context module 里面所包含的模块id.它可能在你使用 module.hot.accept 时会用到。

require.context应用场景

注册全局组件

/*
   所有在./components目录下的.vue组件自动注册为全局组件
   以<mc-***></mc-***>为组件标签名，***是组件的.name
*/
const requireContext = require.context('../components', true, /.vue$/)
const requireAll = context => context.keys().map(context)

console.log(requireContext)
console.log(requireAll(requireContext))
export default (Vue) => {
  requireAll(requireContext).forEach(item => {
    Vue.component(`vc-${item.default.name}`, item.default)
  })
}

引入vuex的module

const files = require.context('./modules', false, /.js$/)
console.log('------------')
console.log(files.keys())
console.log('------------')
const modules = {}

files.keys().forEach(key => { 
   modules[key.replace(/(./|.js)/g, '')] = files(key).default
})

console.log('------------')
console.log(modules)
console.log('------------')
export default modules

引入项目中所有的svg文件

const requireContext = require.context('./svg', false, /.svg/)
const requireAll = context => context.keys().map(context)
requireAll(requireContext)

利用require.context遍历目录所有的图片

<template>
  <div id="app">
    <li v-for="(img, index) in images" :key="index">
      <p>img: {{img}}</p>
      <img :src="imgUrl(img)" alt="">
    </li>
  </div>
</template>

<script>
const req = require.context('./assets/image', false, /(.png|.gif)$/)

export default {
  name: 'App',
  data () {
    return {
      images: []
    }
  },
  created () {
    this.images = req.keys()
  },
  methods: {
    imgUrl (path) {
      return req(path)
    }
  }
}
</script>

<style>
img {
  height: 30px;
}
</style>