什么是模块

  • 将一个复杂的程序依据一定的规则(规范)封装成几个块(文件),并进行组合在一起;
  • 块的内部数据与实现是私有的, 只是向外部暴露一些接口(方法)与外部其它模块通信;

模块化的进化过程

1.全局function模式

将不同的功能封装成不同的全局函数

  • 编码:将不同的功能封装成不同的全局函数
  • 问题:污染全局命名空间, 容易引起命名冲突或数据不安全,而且模块成员之间看不出直接关系
 1function m1(){
 2  
 3}
 4function m2(){
 5  
 6}

2.namespace模式

简单对象封装

  • 作用:减少了全局变量,解决命名冲突
  • 问题:数据不安全(外部可以直接修改模块内部的数据)
 1let myModule = {
 2  data: 'www.baidu.com',
 3  foo() {
 4    console.log(`foo() ${this.data}`)
 5  },
 6  bar() {
 7    console.log(`bar() ${this.data}`)
 8  }
 9}
10myModule.data = 'other data' 
11myModule.foo() 

这样的写法会暴露所有模块成员,内部状态可以被外部改写。

3.IIFE模式

匿名函数自调用(闭包)

  • 作用:数据是私有的, 外部只能通过暴露的方法操作
  • 编码:将数据和行为封装到一个函数内部, 通过给window添加属性来向外暴露接口
  • 问题:如果当前这个模块依赖另一个模块怎么办?
 1
 2<script type="text/javascript" src="module.js"></script>
 3<script type="text/javascript">
 4    myModule.foo()
 5    myModule.bar()
 6    console.log(myModule.data) 
 7    myModule.data = 'xxxx' 
 8    myModule.foo() 
 9</script>
10
11
12(function(window) {
13      let data = 'www.baidu.com'
14  
15  function foo() {
16    
17    console.log(`foo() ${data}`)
18  }
19  function bar() {
20    
21    console.log(`bar() ${data}`)
22    otherFun() 
23  }
24  function otherFun() {
25    
26    console.log('otherFun()')
27  }
28  
29  window.myModule = { foo, bar } 
30})(window)

最后得到的结果:

 1foo() www.baidu.com
 2bar() www.baidu.com
 3undefined
 4foo() www.baidu.com

4.IIFE模式增强

这就是现代模块实现的基石

 1
 2(function(window, $) {
 3  let data = 'www.baidu.com'
 4  
 5  function foo() {
 6    
 7    console.log(`foo() ${data}`)
 8    $('body').css('background', 'red')
 9  }
10  function bar() {
11    
12    console.log(`bar() ${data}`)
13    otherFun() 
14  }
15  function otherFun() {
16    
17    console.log('otherFun()')
18  }
19  
20  window.myModule = { foo, bar }
21})(window, jQuery)
22
23 
24<!-- 引入的js必须有一定顺序 -->
25<script type="text/javascript" src="jquery-1.10.1.js"></script>
26<script type="text/javascript" src="module.js"></script>
27<script type="text/javascript">
28  myModule.foo()
29</script>

上例子通过jquery方法将页面的背景颜色改成红色,所以必须先引入jQuery库,就把这个库当作参数传入。这样做除了保证模块的独立性,还使得模块之间的依赖关系变得明显。

5.模块化的好处

  • 避免命名冲突(减少命名空间污染);
  • 更好的分离, 按需加载;
  • 更高复用性;
  • 高可维护性;

6.引入多个script后出现出现问题

  • 引入顺序

一旦引入顺序出现问题,就可能报错

  • 请求过多

首先我们要依赖多个模块,那样就会发送多个请求,导致请求过多; 同一个域名下限制6个tcp连接,一旦有多个请求,某些请求时间较长时,用户体验感就会大打折扣

  • 依赖模糊

我们不知道他们的具体依赖关系是什么,也就是说很容易因为不了解他们之间的依赖关系导致加载先后顺序出错;

  • 难以维护

以上两种原因就导致了很难维护,很可能出现牵一发而动全身的情况导致项目出现严重的问题。 模块化固然有多个好处,然而一个页面需要引入多个js文件,就会出现以上这些问题。而这些问题可以通过模块化规范来解决,因此才有了后续的commonjs, AMD, ESM, CMD规范。 5. # 模块化规范

CommonJS

1.概念

Node 应用由模块组成,采用 CommonJS 模块规范。每个文件就是一个模块,有自己的作用域。在一个文件里面定义的变量、函数、类,都是私有的,对其他文件不可见。在服务器端,模块的加载是运行时同步加载的;在浏览器端,模块需要提前编译打包处理。

2.特点

  • 所有代码都运行在模块作用域,不会污染全局作用域;
  • 模块可以多次加载,但是只会在第一次加载时运行一次,然后运行结果就被缓存了,以后再加载,就直接读取缓存结果。要想让模块再次运行,必须清除缓存;
  • 模块加载的顺序,按照其在代码中出现的顺序;

3.基本语法

  • 暴露模块:module.exports = valueexports.xxx = value

  • 引入模块:require(xxx),如果是第三方模块,xxx为模块名;如果是自定义模块,xxx为模块文件路径

此处我们有个疑问:CommonJS暴露的模块到底是什么? CommonJS规范规定,每个模块内部,module变量代表当前模块。这个变量是一个对象,它的exports属性(即module.exports)是对外的接口。加载某个模块,其实是加载该模块的module.exports属性。

 1// example.js
 2var x = 5
 3var addX = function (value) {
 4  return value + x
 5}
 6module.exports.x = x
 7module.exports.addX = addX
 8

上面代码通过module.exports输出变量x和函数addX。

 1var example = require('./example.js');
 2console.log(example.x); 
 3console.log(example.addX(1)); 
 4console.log(example.addX(1)); 

require命令用于加载模块文件。require命令的基本功能是,读入并执行一个JavaScript文件,然后返回该模块的exports对象。如果没有发现指定模块,会报错。

模块的加载机制

CommonJS模块的加载机制是,输入的是被输出的值的拷贝。也就是说,一旦输出一个值,模块内部的变化就影响不到这个值。这点与ES6模块化有重大差异(下文会介绍),请看下面这个例子:

 1// lib.js
 2var counter = 3
 3function incCounter() {
 4  counter++
 5}
 6module.exports = {
 7  counter: counter,
 8  incCounter: incCounter,
 9}

上面代码输出内部变量counter和改写这个变量的内部方法incCounter。

 1// main.js
 2var counter = require('./lib').counter
 3var incCounter = require('./lib').incCounter
 4
 5console.log(counter)
 6incCounter()
 7console.log(counter)

上面代码说明,counter输出以后,lib.js模块内部的变化就影响不到counter了。这是因为counter是一个原始类型的值,会被缓存。除非写成一个函数,才能得到内部变动后的值。

服务器端实现

  1. 安装node
  2. npm init
 1|-modules
 2  |-module1.js
 3  |-module2.js
 4  |-module3.js
 5|-app.js
 6|-package.json
 7  {
 8    "name": "commonJS-node",
 9    "version": "1.0.0"
10  }
  1. 下载第三方模块
 1npm install uniq --save 
  1. 定义模块代码
 1
 2module.exports = {
 3  msg: 'module1',
 4  foo() {
 5    console.log(this.msg)
 6  }
 7}
 8
 9
10module.exports = function() {
11  console.log('module2')
12}
13
14
15exports.foo = function() {
16  console.log('foo() module3')
17}
18exports.arr = [1, 2, 3, 3, 2]
19
20
21
22let uniq = require('uniq')
23let module1 = require('./modules/module1')
24let module2 = require('./modules/module2')
25let module3 = require('./modules/module3')
26
27module1.foo() 
28module2() 
29module3.foo() 
30console.log(uniq(module3.arr)) 
  1. node app.js

浏览器端实现

使用Browserify:Browserify 会对代码进行解析,整理出代码中的所有模块依赖关系,然后把相关的模块代码都打包在一起,形成一个完整的JS文件,这个文件中不会存在 require 这类的模块化语法,变成可以在浏览器中运行的普通JS

  1. 创建项目结构
 1|-js
 2  |-dist 
 3  |-src 
 4    |-module1.js
 5    |-module2.js
 6    |-module3.js
 7    |-app.js 
 8|-index.html 
 9|-package.json
10  {
11    "name": "browserify-test",
12    "version": "1.0.0"
13  }
  1. 下载browserify
  • 全局: npm install browserify -g
  • 局部: npm install browserify --save-dev
  1. 定义模块代码

注意:index.html文件要运行在浏览器上,需要借助browserify将app.js文件打包编译,如果直接在index.html引入app.js就会报错!

  1. 打包处理js

根目录下运行

 1browserify js/src/app.js -o js/dist/bundle.js
  1. 页面使用引入

在index.html文件中引入

 1<script type="text/javascript" src="js/dist/bundle.js"></script>

AMD(Asynchronous Module Definition)

  1. 概念

CommonJS规范加载模块是同步的,也就是说,只有加载完成,才能执行后面的操作AMD规范则是非同步加载模块,允许指定回调函数。由于Node.js主要用于服务器编程,模块文件一般都已经存在于本地硬盘,所以加载起来比较快,不用考虑非同步加载的方式,所以CommonJS规范比较适用。但是,如果是浏览器环境,要从服务器端加载模块,这时就必须采用非同步模式,因此浏览器端一般采用AMD规范。此外AMD规范比CommonJS规范在浏览器端实现要来着早。

  1. 基本语法

定义暴露模块:

 1
 2define(function(){
 3   return 模块
 4})
 5
 6
 7define(['module1', 'module2'], function(m1, m2){
 8   return 模块
 9})

引入使用模块:

 1require(['module1', 'module2'], function(m1, m2){
 2   使用m1/m2
 3})
  1. AMD实现

通过比较是否使用AMD,来说明使用AMD实际使用的效果。

  1. 未使用AMD规范

 1
 2(function (window) {
 3  let msg = 'www.baidu.com'
 4  function getMsg() {
 5    return msg.toUpperCase()
 6  }
 7  window.dataService = {getMsg}
 8})(window)
 9
10
11(function (window, dataService) {
12  let name = 'baidu'
13  function showMsg() {
14    alert(dataService.getMsg() + ', ' + name)
15  }
16  window.alerter = {showMsg}
17})(window, dataService)
18
19
20(function (alerter) {
21  alerter.showMsg()
22})(alerter)
23
24
25<div><h1>Modular Demo 1: 未使用AMD(require.js)</h1></div>
26<script type="text/javascript" src="js/modules/dataService.js"></script>
27<script type="text/javascript" src="js/modules/alerter.js"></script>
28<script type="text/javascript" src="js/main.js"></script>

最后得到如下结果:

 1'www.baidu.com', 'baidu'

这种方式缺点很明显:首先会发送多个请求,其次引入的js文件顺序不能搞错,否则会报错

  1. 使用require.js

RequireJS是一个工具库,主要用于客户端的模块管理。它的模块管理遵守AMD规范,RequireJS的基本思想是,通过define方法,将代码定义为模块;通过require方法,实现代码的模块加载。

接下来介绍AMD规范在浏览器实现的步骤:

  1. 下载require.js, 并引入

然后将require.js导入项目: js/libs/require.js

  1. 创建项目结构
 1|-js
 2  |-libs
 3    |-require.js
 4  |-modules
 5    |-alerter.js
 6    |-dataService.js
 7  |-main.js
 8|-index.html
  1. 定义require.js的模块代码
 1
 2
 3define(function() {
 4  let msg = 'www.chenghuai.com'
 5  function getMsg() {
 6    return msg.toUpperCase()
 7  }
 8  return { getMsg } 
 9})
10
11
12
13define(['dataService'], function(dataService) {
14  let name = 'chenghuai'
15  function showMsg() {
16    alert(dataService.getMsg() + ', ' + name)
17  }
18  
19  return { showMsg }
20})
21
22
23(function() {
24  require.config({
25    baseUrl: 'js/', 
26    paths: {
27      
28      alerter: './modules/alerter', 
29      dataService: './modules/dataService'
30    }
31  })
32  require(['alerter'], function(alerter) {
33    alerter.showMsg()
34  })
35})()
36
37
38<!DOCTYPE html>
39<html>
40  <head>
41    <title>Modular Demo</title>
42  </head>
43  <body>
44    
45    <script data-main="js/main" src="js/libs/require.js"></script>
46  </body>
47</html>
  1. 页面引入require.js模块

在index.html引入

 1<script data-main="js/main" src="js/libs/require.js"></script>
  1. 引入第三方库
 1
 2define(['dataService', 'jquery'], function(dataService, $) {
 3  let name = 'Tom'
 4  function showMsg() {
 5    alert(dataService.getMsg() + ', ' + name)
 6  }
 7  $('body').css('background', 'green')
 8  
 9  return { showMsg }
10})
 1
 2(function() {
 3  require.config({
 4    baseUrl: 'js/', 
 5    paths: {
 6      
 7      alerter: './modules/alerter', 
 8      dataService: './modules/dataService',
 9      
10      jquery: './libs/jquery-1.10.1' 
11    }
12  })
13  require(['alerter'], function(alerter) {
14    alerter.showMsg()
15  })
16})()

上例是在alerter.js文件中引入jQuery第三方库,main.js文件也要有相应的路径配置。

  1. 总结

通过两者的比较,可以得出AMD模块定义的方法非常清晰,不会污染全局环境,能够清楚地显示依赖关系。AMD模式可以用于浏览器环境,并且允许非同步加载模块,也可以根据需要动态加载模块。

CMD(Common Module Definition)

  1. 概念

CMD规范专门用于浏览器端,模块的加载是异步的,模块使用时才会加载执行。CMD规范整合了CommonJS和AMD规范的特点。在 Sea.js 中,所有 JavaScript 模块都遵循 CMD模块定义规范。

  1. 基本语法

 1
 2define(function(require, exports, module){
 3  exports.xxx = value
 4  module.exports = value
 5})
 1
 2define(function(require, exports, module){
 3  
 4  var module2 = require('./module2')
 5  
 6    require.async('./module3', function (m3) {
 7    })
 8  
 9  exports.xxx = value
10})
 1
 2define(function (require) {
 3  var m1 = require('./module1')
 4  var m4 = require('./module4')
 5  m1.show()
 6  m4.show()
 7})

CMD实现

  1. 下载sea.js, 并引入

然后将sea.js导入项目:js/libs/sea.js

  1. 创建项目结构
 1|-js
 2  |-libs
 3    |-sea.js
 4  |-modules
 5    |-module1.js
 6    |-module2.js
 7    |-module3.js
 8    |-module4.js
 9    |-main.js
10|-index.html
  1. 定义sea.js的模块代码
 1
 2define(function (require, exports, module) {
 3  
 4  var data = 'chenghuai.com'
 5  
 6  function show() {
 7    console.log('module1 show() ' + data)
 8  }
 9  
10  exports.show = show
11})
12
13
14define(function (require, exports, module) {
15  module.exports = {
16    msg: 'I am chenghuai'
17  }
18})
19
20
21define(function(require, exports, module) {
22  const API_KEY = 'abc123'
23  exports.API_KEY = API_KEY
24})
25
26
27define(function (require, exports, module) {
28  
29  var module2 = require('./module2')
30  function show() {
31    console.log('module4 show() ' + module2.msg)
32  }
33  exports.show = show
34  
35  require.async('./module3', function (m3) {
36    console.log('异步引入依赖模块3  ' + m3.API_KEY)
37  })
38})
39
40
41define(function (require) {
42  var m1 = require('./module1')
43  var m4 = require('./module4')
44  m1.show()
45  m4.show()
46})
  1. 在index.html中引入
 1<script type="text/javascript" src="js/libs/sea.js"></script>
 2<script type="text/javascript">
 3  seajs.use('./js/modules/main')
 4</script>

最后得到结果如下:

 1module1 show(), chenghuai
 2module4 show() I am chenghuai
 3异步引入依赖模块3 abc123
  1. AMD与CMD区别

 1
 2define(function (requie, exports, module) {
 3    
 4    var module1 = require('Module1');
 5    var result1 = module1.exec();
 6    module.exports = {
 7      result1: result1,
 8    }
 9});
10
11
12define(['Module1'], function (module1) {
13    var result1 = module1.exec();
14    return {
15      result1: result1,
16    }
17});

从上面的代码比较中我们可以得出AMD规范和CMD规范的区别

  1. 对依赖的处理:
  • AMD推崇依赖前置,即通过依赖数组的方式提前声明当前模块的依赖;
  • CMD推崇依赖就近,在编程需要用到的时候通过调用require方法动态引入;
  1. 在本模块的对外输出:
  • AMD推崇通过返回值的方式对外输出;
  • CMD推崇通过给module.exports赋值的方式对外输出;

ESM 下模块之间的依赖关系是高度确定的,与运行状态无关,编译工具只需要对 ESM 模块做静态分析,就可以从代码字面量中推断出哪些模块值未曾被其它模块使用,这是实现 Tree Shaking 技术的必要条件。

ES6模块化

  1. 概念

ES6 模块的设计思想是尽量的静态化,使得编译时就能确定模块的依赖关系,以及输入和输出的变量。CommonJSAMD 模块,都只能在运行时确定这些东西。比如,CommonJS 模块就是对象,输入时必须查找对象属性。

  1. 基本使用

export命令用于规定模块的对外接口,import命令用于输入其他模块提供的功能。

 1/** 定义模块 math.js / 
 2var basicNum = 0
 3var add = function (a, b) { 
 4    return a + b
 5    }
 6 export { basicNum, add }
 7 / 引用模块 **/
 8import { basicNum, add } from './math'
 9function test(ele) {
10    ele.textContent = add(99 + basicNum)
11}

如上例所示,使用import命令的时候,用户需要知道所要加载的变量名或函数名,否则无法加载。为了给用户提供方便,让他们不用阅读文档就能加载模块,就要用到export default命令,为模块指定默认输出。

 1
 2export default function () {
 3  console.log('foo');
 4}
 5
 6
 7import customName from './export-default';
 8customName(); 

模块默认输出, 其他模块加载该模块时,import命令可以为该匿名函数指定任意名字。

ES6 模块与 CommonJS 模块的差异

  1. CommonJS 模块输出的是一个值的拷贝,ES6 模块输出的是值的引用

  2. CommonJS 模块是运行时加载,ES6 模块是编译时输出接口

第二个差异是因为 CommonJS 加载的是一个对象(即module.exports属性),该对象只有在脚本运行完才会生成。而 ES6 模块不是对象,它的对外接口只是一种静态定义,在代码静态解析阶段就会生成。

下面重点解释第一个差异,我们还是举上面那个CommonJS模块的加载机制例子:

es6

 1
 2export let counter = 3;
 3export function incCounter() {
 4  counter++;
 5}
 6
 7import { counter, incCounter } from './lib';
 8console.log(counter); 
 9incCounter();
10console.log(counter); 

commonjs

 1// main.js var counter = require('./lib').counter
 2 var incCounter = require('./lib').incCounter
 3 console.log(counter)
 4 incCounter()
 5 console.log(counter)

ES6 模块的运行机制与 CommonJS 不一样。ES6 模块是动态引用,并且不会缓存值,模块里面的变量绑定其所在的模块

  1. ES6实现

简单来说就一句话:使用Babel将ES6编译为ES5代码,使用Browserify编译打包js。

  1. 定义package.json文件
 1 {
 2   "name" : "es6-babel-browserify",
 3   "version" : "1.0.0"
 4 }
  1. 安装babel-cli, babel-preset-es2015和browserify
 1npm install babel-cli browserify -g
 2npm install babel-preset-es2015 --save-dev
  1. 定义.babelrc文件
 1  {
 2    "presets": ["es2015"]
 3  }
  1. 定义模块代码
 1
 2
 3export function foo() {
 4  console.log('foo() module1')
 5}
 6export function bar() {
 7  console.log('bar() module1')
 8}
 9
10
11
12function fun1() {
13  console.log('fun1() module2')
14}
15function fun2() {
16  console.log('fun2() module2')
17}
18export { fun1, fun2 }
19
20
21
22export default () => {
23  console.log('默认暴露')
24}
25
26
27import { foo, bar } from './module1'
28import { fun1, fun2 } from './module2'
29import module3 from './module3'
30foo()
31bar()
32fun1()
33fun2()
34module3()
  1. 编译并在index.html中引入
  • 使用Babel将ES6编译为ES5代码(但包含CommonJS语法) : babel js/src -d js/lib
  • 使用Browserify编译js : browserify js/lib/app.js -o js/lib/bundle.js

然后在index.html文件中引入

 1 <script type="text/javascript" src="js/lib/bundle.js"></script> 

最后得到如下结果:

 1foo() module1
 2bar() module1
 3fun1() module2
 4fun2() module2
 5默认暴露
  1. 引入第三方库 首先安装依赖npm install jquery@1,然后在app.js文件中引入
 1
 2import { foo, bar } from './module1'
 3import { fun1, fun2 } from './module2'
 4import module3 from './module3'
 5import $ from 'jquery'
 6
 7foo()
 8bar()
 9fun1()
10fun2()
11module3()
12$('body').css('background', 'green')

UMD(Universal Module Definition)

是一种javascript通用模块定义规范,让你的模块能在javascript所有运行环境中发挥作用。

意味着要同时满足CommonJS, AMD, CMD的标准,以下为实现:

 1(function(root, factory) {
 2    if (typeof module === 'object' && typeof module.exports === 'object') {
 3        console.log('是commonjs模块规范,nodejs环境')
 4        module.exports = factory();
 5    } else if (typeof define === 'function' && define.amd) {
 6        console.log('是AMD模块规范,如require.js')
 7        define(factory)
 8    } else if (typeof define === 'function' && define.cmd) {
 9        console.log('是CMD模块规范,如sea.js')
10        define(function(require, exports, module) {
11            module.exports = factory()
12        })
13    } else {
14        console.log('没有模块环境,直接挂载在全局对象上')
15        root.umdModule = factory();
16    }
17}(this, function() {
18    return {
19        name: '我是一个umd模块'
20    }
21}))

总结

  1. CommonJS规范主要用于服务端编程,加载模块是同步的,这并不适合在浏览器环境,因为同步意味着阻塞加载,浏览器资源是异步加载的,因此有了AMD CMD解决方案
  2. AMD规范在浏览器环境中异步加载模块,而且可以并行加载多个模块。不过,AMD规范开发成本高,代码的阅读和书写比较困难,模块定义方式的语义不顺畅;
  3. CMD规范与AMD规范很相似,都用于浏览器编程,依赖就近,延迟执行,可以很容易在Node.js中运行;
  4. ES6 在语言标准的层面上,实现了模块功能,而且实现得相当简单,完全可以取代 CommonJS 和 AMD 规范,成为浏览器和服务器通用的模块解决方案
  5. UMD为同时满足CommonJS, AMD, CMD标准的实现;
个人笔记记录 2021 ~ 2025