webpack中require.context的运用

require.context是webpack提供的一种在编译时动态批量导入模块的方法,主要用于处理含有表达式的require调用。它接受目录、是否搜索子目录和正则表达式作为参数,返回一个上下文模块,该模块导出的函数可以按需加载匹配的模块。文章介绍了require.context的使用方法,如自动化注册Vue组件和动态导入路由文件,并强调了它可能导致所有可能用到的模块都被包含在bundle中。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1. 作用:

利用require创建context (上下文),来告知在编译时具体需要导入哪些模块(即:批量处理待导入模块进行导入);
webpack会在构建的时候解析代码中的require.context() (实际上是webpack的方法,vue一般基于webpack,所以可以使用)

1-1. 背景:

当我们代码的request中含有表达式(expressions)时,就会创建一个上下文(context),因为在编译时(compile time)不清楚具体导入哪个模块;

例如:我们项目中可能会包含 .ejs 的文件目录:

example_directory
│
└───template
│   │   table.ejs
│   │   table-row.ejs
│   │
│   └───directory
│       │   another.ejs

那么 require() 调用会被评估解析:

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

webpack会解析 require() 调用,并提取出以下信息:

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

然后会生成一个 context module(上下文模块)。它包含目录下的所有模块 的引用如果一个request 符合正则表达式,就能require进来。该context module包含一个map(映射)对象,会把requests翻译成对应模块的id。
示例map(映射)对象:

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

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

2. 使用:

require.context()可以传入三个参数:要搜索的目录,表示是否还搜索其子目录的标记,匹配文件的正则表达式:

require.context(
  directory,
  (useSubdirectories = true),
  (regExp = /^\.\/.*$/),
  (mode = 'sync')
);

示例:

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

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

3. 返回:

require.context创建出一个context,一个context module会导出一个(require)函数,此函数可以接收一个参数:request。 此导出函数有三个属性:resolve、keys、id

  • resolve:是一个函数,它返回request被解析后得到的模块id。
  • keys:也是一个函数,它返回一个数组,由所有可能被此 context module 处理的请求组成(即符合require.context()参数中正则表达式的所有文件的组成)。
  • id:是 context module 的模块 id. 它可能在你使用 module.hot.accept 时会用到。

如果想引入一个文件夹下面的所有文件,或者引入能匹配一个正则表达式的所有文件,这个功能就很有用:

function importAll(r) {
  r.keys().forEach(r);
}

importAll(require.context('../components/', true, /\.js$/));
const cache = {};

function importAll(r) {
  r.keys().forEach((key) => (cache[key] = r(key)));
}

importAll(require.context('../components/', true, /\.js$/));
// 在构建时(build-time),所有被 require 的模块都会被填充到 cache 对象中。

4. 运用:

4-1. 动态将components文件下的组件自动化注册为全局组件:
// main.js文件:

import Vue from "vue";

// 自动加载components目录下的 .vue 结尾的文件 第二参数是是否查询其子目录
const requireComponent  = require.context("./components", true, /\.vue$/);

requireComponent.keys().forEach(fileName  => {
  const componentConfig = requireComponent(fileName);
 // 兼容 import export 和 require module.export 两种规范
  const ctrl = componentConfig.default || componentConfig;
  Vue.component(ctrl.name, ctrl);
});
4-2. 动态导入router文件下所有的分模块路由文件
// routes.js:

import Vue from 'vue'
import VueRouter from 'vue-router'
Vue.use(VueRouter)

const routerAry = []
// 自动加载modules目录下的 .js 结尾的文件
const requireRouter  = require.context("./modules", true, /\.js$/);

requireRouter.keys().forEach(fileName => {
    const routerConfig = requireRouter(fileName);
    routerAry.push(routerConfig);
})

const routes = [
    {
    path: '/login',
    component: load('login'),
    meta: {
      requireAuth: false,
      title: '登录'
    }
  },
  ...routerAry  
]
在Vue项目中,要正确配置webpack以使用require.context进行动态导入,你需要按照以下步骤操作: 1. **理解require.context**:require.context是一个webpack的编译时函数,允许你创建自己的上下文,用于动态导入。你可以指定一个目录,是否搜索子目录,以及匹配文件的正则表达式。 2. **配置webpack**:在webpack的配置文件(通常是webpack.config.js)中,你需要确保有两个配置选项是启用的: - **context**:设置为你的项目源文件的根目录。 - **resolve.alias**:这可以用来定义模块的别名,使得require.context可以更方便地使用。 3. **使用require.context**:在你的Vue组件或JavaScript文件中,你可以使用require.context来创建上下文,并使用它的.keys()和.resolve()方法动态地加载模块。 以下是一个简单的配置示例: ```javascript // 在webpack.config.js中 const path = require('path'); module.exports = { //... resolve: { alias: { // 设置别名,例如: '@': path.resolve(__dirname, 'src'), // 其他别名... }, }, //... }; // 在Vue组件或JavaScript文件中使用require.context const files = require.context('路径', 是否递归搜索, 正则表达式); const modules = files.keys().reduce((modules, modulePath) => { const key = modulePath.replace(/(\.\/|\.js)/g, ''); modules[key] = files(modulePath); return modules; }, {}); ``` 这里是一个具体的使用场景: ```javascript // 假设我们有一个目录结构如下: // components/ // ├── Button.vue // ├── Icon.vue // └── Layout/ // ├── Header.vue // ├── Footer.vue // 我们想动态加载components目录下的所有组件 const requireComponent = require.context('./components', false, /\.vue$/); const components = requireComponent.keys().reduce((components, filePath) => { const componentConfig = requireComponent(filePath); const componentName = filePath.split('/').pop().split('.')[0]; components[componentName] = componentConfig.default || componentConfig; return components; }, {}); // 现在可以在Vue实例中这样使用components对象: // components: { // Button: components.Button, // Icon: components.Icon, // LayoutHeader: components.LayoutHeader, // LayoutFooter: components.LayoutFooter // } ```
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值