webpack4实现不同的导出类型

Z时代
2024-01-10
分类：综合

webpack最基本的配置就是导出一个静态的对象，但是由于我们业务比较复杂，往往需要动态配置webpack以构建目标代码。

幸运的是，webpack为我们提供了动态配置webpack文件的支持。

下面介绍一下webpack的多种配置类型。

1、导出为一个对象（Object）

webpack最常见的配置类型为导出一个对象，即


const path = require('path')
module.exports = {
 entry: './src/index.js',
 output: {
  filename: 'bundle.js',
  path: path.resolve(__dirname, 'dist')
 }
}

2、导出为一个函数（Function）

很明显，导出为一个对象缺乏灵活性。若我们想要根据不同的开发环境构建不一样的代码。此时，webpack配置也应该随着改变。

所以，webpack支持我们导出一个函数，这个导出函数的默认参数为env和argv。其中，env为环境对象，我们可以通过命令行对其进行配置（webpack可自动读取该配置），argv为命令行输入参数的map。

（1）--env 参数支持各种各样的配置：

Invocation	Resulting environment	notes
webpack --env prod	"prod"	env为String类型，赋值为prod
webpack --env.prod	{ prod: true }	env为对象，prod是对象的属性，默认为true
webpack --env.prod=1	{ prod: 1 }	env为对象，prod是对象的属性，赋值为1
webpack --env.prod=foo	{ prod: "foo" }	env为对象，prod是对象的属性，赋值为foo
webpack --env.prod --env.min	[ prod: true, min: true ]	env为对象，prod和min是对象的属性，默认为true。--env命令可以多次使用，不会被覆盖
webpack --env.prod --env min	[{ prod: true }, "min"]	env 为数组，第一个数组元素为对象，prod是其属性，默认为true。第二个数组元素为String，赋值为min
webpack --env.prod=foo --env.prod=bar	{ prod: ["foo", "bar"] }	env为对象，prod是对象的属性。prod是一个数组，第一个数组元素为"foo",第二个数组对象为"bar"。注意，即使这种情况下，prod值不会被覆盖，而是转化为数组。

（2）argv为webpack命令行参数的map。

例如，我们在命令行键入webpack --entry-filename=index,则在webpack配置文件中，我们可以通过argv["entry-filename"]来获取命令行配置的值。即：

argv["entry-filename"] === "index"

（3）举个例子：


const path = require('path')
module.exports = function (env, argv) {
 return {
  entry: './src/' + argv['entry-filename'] + '.js',
  output: {
   filename: 'bundle.js',
   path: path.resolve(__dirname, 'dist'),
  },
  devtool: env.prod ? 'source-map' : 'eval'
 }
}

在命令行中，我们需要自键入

webpack --env.prod --entry-filename=index

注意，凡是webpack配置文件中使用到的命令行参数，例如argv["entry-filename"]，均需要在命令行传入，一个不能遗漏，否则webpack会报错：Config did not export an object

3、导出为一个Promise对象

除了导出为一个函数，webpack还支持我们异步获取配置变量来配置相关文件。（真是很强大！）

为了体现异步获取数据的过程，我们把webpack.config.js修改为以下内容：


const path = require('path')
module.exports = () => {
 return new Promise((resolve, reject) => {
  setTimeout(() => {
   resolve({
    entry: './src/index.js',
    output: {
     filename: 'bundle.js',
     path: path.resolve(__dirname, 'dist')
    }
   })
  }, 1000)
 })
}

4、导出多个配置

修改webpack.config.js的内容如下：


const path = require('path')
module.exports = [
 {
  name: 'index',
  entry: './src/index.js',
  output: {
   filename: 'index.js',
   path: path.resolve(__dirname, 'dist')
  },
  mode: 'production'
 },
 {
  name: 'main',
  entry: './src/main.js',
  output: {
   filename: 'main.js',
   path: path.resolve(__dirname, 'dist')
  }
 }
]

当我们运行webpack时，以上多个配置都会被构建出来。如果我们只想构建其中一份代码，那么只需要传入--config-name参数即可：

webpack --config-name=index

webpack --config-name=main

如上所示，我们可以分别构建出name为index、name为main的配置对象所配置的内容。

以上配置常见的场景有：npm包利用不同的模块语法构建不同的输出文件，供不同的项目进行使用：


module.exports = [{
 output: {
  filename: './dist-amd.js',
  libraryTarget: 'amd'
 },
 name: 'amd',
 entry: './app.js',
 mode: 'production',
},{
 output: {
  filename: './dist-commonjs.js',
  libraryTarget: 'commonjs'
 },
 name: 'commonjs',
 entry: './app.js',
 mode: 'production',
}]