webpack的externals的使用

externals

官网文档解释的很清楚，就是webpack可以不处理应用的某些依赖库，使用externals配置后，依旧可以在代码中通过CMD、AMD或者window/global全局的方式访问。

怎么理解呢？我们先通过官网说的那个jquery的案例来理解。

有时我们希望我们通过script引入的库，如用CDN的方式引入的jquery，我们在使用时，依旧用require的方式来使用，但是却不希望webpack将它又编译进文件中。

 

 <script src="http://code.jquery.com/jquery-1.12.0.min.js"></script>

 

jquery的使用如下

  // 我们不想这么用
  // const $ = window.jQuery

  // 而是这么用
  const $ = require("jquery")
  $("#content").html("<h1>hello world</h1>")

　　

这时，我们便需要配置externals

module.exports = {
    ...
    output: {
      ...
      libraryTarget: "umd"
    },
    externals: {
      jquery: "jQuery"
    },
    ...
 }

我们可以看看编译后的文件

({
   0: function(...) {
       var jQuery = require(1);
       /* ... */
   },
   1: function(...) {
     // 很明显这里是把window.jQuery赋值给了module.exports
     // 因此我们便可以使用require来引入了。
     module.exports = jQuery;
   },
     /* ... */
});

　　

我们自己可以写个例子，当然这个例子没什么实际意义，只是为了演示如何使用而已。

假设我们自己有个工具库，tools.js，它并没有提供给我们UMD的那些功能，只是使用window或者global的方式把工具的对象tools暴露出来

window.Tools = {
    add: function(num1, num2) {
      return num1 + num2
    }
  }

接下来把它放在任何页面能够引用到的地方，例如CDN，然后用script的方式引入页面

 <script src="http://xxx/tools.min.js"></script>

一般来说我们可能会直接就这么用了

const res = Tools.add(1,2)

但是既然我们是模块化开发，当然要杜绝一切全局变量了，我们要用require的方式。

 const tools = require('mathTools')
 const res = tools.add(1,2)

　　

这是我们再来配置一些externals即可

   module.exports = {
     ...
     output: {
       ...
       libraryTarget: "umd"
     },
     externals: {
       mathTools: "tools"
     },
     ...
   }

关于externals的配置

首先是libraryTarget的配置，我们上面的例子都是umd 
当然它还有其他配置方式，具体就看官网文档吧，我们可以看到配置成umd便可以使用任何一种引入的方式了