exports-loader

exports,导出的意思,顾名思义,这个loader是用来将(模块中的)某些内容导出的。之所以为“模块中的”加上括号,是因为实际上只要在模块中能被访问到的成员(变量)都可以被导出,当然也包括全局变量。

export导出在这里有特定含义,指将模块中的内容暴露出来,供使用方使用。例如CommonJS中的exports.xxx=xxx或者module.exports=xxx,以及AMD中的return xxx都叫导出,导出后外部模块引用时就可以使用被导出的部分。没导出的部分将作为模块私有部分,外部无法访问。

导出全局变量

在实际使用中,用exports-loader最多的场景是将某些不支持模块化规范的模块所声明的全局变量作为模块内容导出。以Angular.js为例(1.3.14以下版本),它不支持模块化引用,因此如果直接使用以下代码引用angular是无效的:

  1. var angular = require('angular');

此时,angular仍然是一个挂载在window上的全局变量,而require返回的却是undefined,导致上述angular变量为空。此时就需要我们使用exports-loader将全局的window.angular作为angular模块的返回值暴露出来。

看一个例子,在这个例子中,我们没有真的引用angular.js,而是在example1.2.js中声明了一个全局变量HELLO

  1. window.Hello = function(){
  2. console.log('hello from global Hello() function');
  3. };

接下来,在example1.1.js中引用这个模块:

  1. var Hello = require('./example1.2');
  2. Hello();

然后直接使用webpack打包,生成bundle1.js,运行截图如下:

exports-loader

可以看到,由于example1.2并没有导出模块,导致example1.1在引用的时候报错,找不到Hello这个函数。

此时就轮到exports-loader上场了。我们建立一个webpack.config.js

  1. module.exports = {
  2. module:{
  3. loaders:[
  4. { test: require.resolve('./example1.2'), loader: "exports?Hello" }
  5. ]
  6. }
  7. };

其中的test表示使用loader的条件,这里使用了require.resolve解析出来的路径,表示只处理example1.2.js,loader中指定了exports-loader,参数为Hello,意为将Hello作为模块导出值。

重新打包生成bundle2.js,运行截图如下:

exports-loader

可见Hello函数已被正确调用。

查看bundle2.js中的代码可以清楚地看到HELLO被导出的过程:

  1. /***/ function(module, exports) {
  2. window.Hello = function(){
  3. console.log('hello from global Hello() function');
  4. };
  5. /*** EXPORTS FROM exports-loader ***/
  6. module.exports = Hello;
  7. /***/ }

注:这里其实有两个示例,分别生成了bundle1.jsbundle2.js,由于bundle1.js需要在webpack.config.js生效前创建,因此如果你克隆代码后自己运行的话,在生成bundle1.js前请将webpack.config.js改名,否则其中的配置会生效,最终效果和第二例一样。

导出局部变量

如前文所述,exports-loader可以导出一切在模块内可以访问的变量,因此如果模块内定义了一个局部变量,也是可以导出的,方法和上面的例子几乎完全一样,这里就不再演示。

更多用法

上面例子中的配置文件是通过webpack.config.js来指定的,你也可以选择用其它方法来指定,详情见使用loader

此外,上面例子中我们只导出了一个变量,此时该变量就是模块被引用时的值(通过module.exports导出)。事实上,exports-loader还可以支持同时导出多个变量,例如exports?HELLO,WORLD会生成如下代码:

  1. exports.HELLO = HELLO;
  2. exports.WORLD = WORLD;

此时模块的导出值是一个对象,其中的各个键值对是我们指定的变量,引用时需要使用类似require('example1.2').HELLO的形式。

exports-loader还支持变量名和导出名不同,例如exports?HELLO=obj.hello,WORLD=shijie会生成如下代码:

  1. exports.HELLO = obj.hello;
  2. exports.WORLD = shijie;

一目了然,不再解释。

本文全部示例代码见https://github.com/TooBug/webpack-guide/tree/master/examples/chapter4/exports-loader/example1