珠峰培训

webpack中的externals的使用

作者:高姗

2017-01-17 14:01:13

11113

珠峰VUE快速入门与实战的视频下载地址:https://pan.baidu.com/s/1pKB97sR

React快速入门与实战的视频下载地址:https://pan.baidu.com/s/1nv7QaAP

Node从入门到实战的视频下载地址:https://pan.baidu.com/s/1nvC9M3Z

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便可以使用任何一种引入的方式了