导读 JavaScript 模块化 CommonJS/AMD/CMD/UMD/ES6 Module 有何区别呢

JavaScript 模块化进程

随着 JS 技术的不断发展,途中会遇到各种问题,比如模块化。那什么是模块化呢,其目的是什么?

定义:如何把一段代码封装成一个有效单元,以及如何注册此模块、输出值、如何引用其它代码单元

到目前为止,大概分为以下几个里程碑式节点。

  1. 原始的开发方式 ---> CommonJS ---> AMD ---> CMD ---> UMD ---> ES6 Module

原始的开发方式

最开始的时候,JS自身是没有模块机制的。项目有多个js文件。

  1. // a.js
  2. function foo() {}
  3. // b.js
  4. function bar() {}
  5. // c.js
  6. foo()

HTML加载

  1. <script src="a.js"></script>
  2. <script src="b.js"></script>
  3. <script src="c.js"></script>

原始的开发方式,随着项目的复杂度,代码量越来越多,所需要加载的文件也越来越多,这个时候,就要考虑几个问题了:

  1. 命名问题:所有文件的方法都是挂载到global上,会污染全局环境,并且需要考虑命名冲突问题。
  2. 依赖问题:script是顺序加载的,如果各文件之间有依赖,那我们得考虑加载.js文件的书写顺序。
  3. 网络问题。如果文件过多,所需请求次数会增多,增加加载时间。

CommonJS && Node.js

CommonJS规范,主要运行于服务器端,同步加载模块,而加载的文件资源大多数在本地服务器,所以执行速度或时间没问题。Node.js很好的实现了该规范。
该规范指出,一个单独的文件就是一个模块。
模块功能主要的几个命令:requiremodule.exportsrequire命令用于输入其他模块提供的功能,module.exports命令用于规范模块的对外接口,输出的是一个值的拷贝,输出之后就不能改变了,会缓存起来。

  1. // moduleA.js
  2. var name = 'weiqinl'
  3. function foo() {}
  4. module.exports = exports = {
  5. name,
  6. foo
  7. }
  8. // moduleB.js
  9. var ma = require('./moduleA') // 可以省略后缀.js
  10. exports.bar = function() {
  11. ma.name === 'weiqinl' // true
  12. ma.foo() // 执行foo方法
  13. }
  14. // moduleC.js
  15. var mb = require('./moduleB')
  16. mb.bar()

通过例子,我们可以看出require(moduleId)来加载其他模块的内容,其返回值就是其引用的外部模块所暴露的API,之后再通过module.exports或者exports来为当前模块的方法和变量提供输出接口。

最后通过node来执行模块。

AMD && Require.js

AMD规范文档
AMD(Asynchronous Module Definition - 异步加载模块定义)规范,制定了定义模块的规则,一个单独的文件就是一个模块,模块和模块的依赖可以被异步加载。主要运行于浏览器端,这和浏览器的异步加载模块的环境刚好适应,它不会影响后面语句的运行。该规范是在RequireJs的推广过程中逐渐完善的。

模块功能主要的几个命令:definerequirereturndefine.amddefine是全局函数,用来定义模块,define(id?, dependencies?, factory)require命令用于输入其他模块提供的功能,return命令用于规范模块的对外接口,define.amd属性是一个对象,此属性的存在来表明函数遵循AMD规范。

  1. // moduleA.js
  2. define(['jQuery','lodash'], function($, _) {
  3. var name = 'weiqinl',
  4. function foo() {}
  5. return {
  6. name,
  7. foo
  8. }
  9. })
  10. // index.js
  11. require(['moduleA'], function(a) {
  12. a.name === 'weiqinl' // true
  13. a.foo() // 执行A模块中的foo函数
  14. // do sth...
  15. })
  16. // index.html
  17. <script src="js/require.js" data-main="js/index"></script>

在这里,我们使用define来定义模块,return来输出接口, require来加载模块,这是AMD官方推荐用法。当然也可以使用其他兼容性的写法,比如对 Simplified CommonJS Wrapper 格式的支持,但背后还是原始AMD的运行逻辑。
AMD的运行逻辑是:提前加载,提前执行。在Requirejs中,申明依赖模块时,会第一时间加载并执行模块内的代码,使后面的回调函数能在所需的环境中运行。
为了更好地优化请求,同时推出了打包工具r.js,使所需加载的文件数减少。

CMD && Sea.js

CMD规范文档
CMD(Common Module Definition - 通用模块定义)规范主要是Sea.js推广中形成的,一个文件就是一个模块,可以像Node.js一般书写模块代码。主要在浏览器中运行,当然也可以在Node.js中运行。

  1. // moduleA.js
  2. // 定义模块
  3. define(function(require, exports, module) {
  4. var func = function() {
  5. var a = require('./a') // 到此才会加载a模块
  6. a.func()
  7. if(false) {
  8. var b = require('./b') // 到此才会加载b模块
  9. b.func()
  10. }
  11. }
  12. // do sth...
  13. exports.func = func;
  14. })
  15. // index.js
  16. // 加载使用模块
  17. seajs.use('moduleA.js', function(ma) {
  18. var ma = math.func()
  19. })
  20. // HTML,需要在页面中引入sea.js文件。
  21. <script src="./js/sea.js"></script>
  22. <script src="./js/index.js"></script>

这里define是一个全局函数,用来定义模块,并通过exports向外提供接口。之后,如果要使用某模块,可以通过require来获取该模块提供的接口。最后使用某个组件的时候,通过seajs.use()来调用。

  1. 通过exports暴露接口。这意味着不需要命名空间了,更不需要全局变量。
  2. 通过require引入依赖。这可以让依赖内置,我们只需要关心当前模块的依赖。关注度分离

CMD推崇依赖就近,延迟执行。在上面例子中,通过require引入的模块,只有当程序运行到此处的时候,模块才会自动加载执行。

同时推出了spm(static package manager)的打包方式,听说支付宝的项目在使用。

UMD && Webpack

UMD文档
UMD(Universal Module Definition - 通用模块定义)模式,该模式主要用来解决CommonJS模式和AMD模式代码不能通用的问题,并同时还支持老式的全局变量规范。

  1. // 使用Node, AMD 或 browser globals 模式创建模块
  2. (function (root, factory) {
  3. if (typeof define === 'function' && define.amd) {
  4. // AMD模式. 注册为一个匿名函数
  5. define(['b'], factory);
  6. } else if (typeof module === 'object' && module.exports) {
  7. // Node等类CommonJS的环境
  8. module.exports = factory(require('b'));
  9. } else {
  10. // 浏览器全局变量 (root is window)
  11. root.returnExports = factory(root.b);
  12. }
  13. }(typeof self !== 'undefined' ? self : this, function (b) {
  14. // 以某种方式使用 b
  15. //返回一个值来定义模块导出。(即可以返回对象,也可以返回函数)
  16. return {};
  17. }));
  1. 判断define为函数,并且是否存在define.amd,来判断是否为AMD规范,
  2. 判断module是否为一个对象,并且是否存在module.exports来判断是否为CommonJS规范
  3. 如果以上两种都没有,设定为原始的代码规范。

这种模式,通常会在webpack打包的时候用到。output.libraryTarget将模块以哪种规范的文件输出。

ES6 Module && ES6

ES6模块加载文档
在ECMAScript 2015版本出来之后,确定了一种新的模块加载方式,我们称之为ES6 Module。它和前几种方式有区别和相同点。

  1. 它因为是标准,所以未来很多浏览器会支持,可以很方便的在浏览器中使用。
  2. 它同时兼容在node环境下运行。
  3. 模块的导入导出,通过importexport来确定。
  4. 可以和Commonjs模块混合使用。
  5. CommonJS输出的是一个值的拷贝。ES6模块输出的是值的引用,加载的时候会做静态优化。
  6. CommonJS模块是运行时加载确定输出接口,ES6模块是编译时确定输出接口。

ES6模块功能主要由两个命令构成:importexportimport命令用于输入其他模块提供的功能。export命令用于规范模块的对外接口。

export的几种用法

  1. // 输出变量
  2. export var name = 'weiqinl'
  3. export var year = '2018'
  4. // 输出一个对象(推荐)
  5. var name = 'weiqinl'
  6. var year = '2018'
  7. export { name, year}
  8. // 输出函数或类
  9. export function add(a, b) {
  10. return a + b;
  11. }
  12. // export default 命令
  13. export default function() {
  14. console.log('foo')
  15. }

import导入其他模块

  1. // 正常命令
  2. import { name, year } from './module.js' //后缀.js不能省略
  3. // 如果遇到export default命令导出的模块
  4. import ed from './export-default.js'

模块编辑好之后,它可以以多种形式加载。

浏览器加载

浏览器加载ES6模块,使用<script>标签,但是要加入type="module"属性
外链js文件

  1. <script type="module" src="index.js"></script>

也可以内嵌在网页中

  1. <script type="module">
  2. import utils from './utils.js';
  3. // other code
  4. </script>

对于加载外部模块,需要注意:

  • 代码是在模块作用域之中运行,而不是在全局作用域运行。模块内部的顶层变量,外部不可见。
  • 模块脚本自动采用严格模式,不管有没有声明use strict
  • 模块之中,可以使用import命令加载其他模块(.js后缀不可省略,需要提供绝对 URL 或相对 URL),也可以使用export命令输出对外接口。
  • 模块之中,顶层的this关键字返回undefined,而不是指向window。也就是说,在模块顶层使用this关键字,是无意义的。
  • 同一个模块如果加载多次,将只执行一次。

Node.js 加载

Node要求 ES6 模块采用.mjs后缀文件名。也就是说,只要脚本文件里面使用import或者export命令,就必须采用.mjs后缀名。
这个功能还在试验阶段。安装Node V8.5.0或以上版本,要用--experimental-modules参数才能打开该功能。

  1. $ node --experimental-modules my-app.mjs

Nodeimport命令只支持异步加载本地模块(file:协议),不支持加载远程模块。

总结

以上即是,我对 JS 模块化概念,理论结合实践完成的简单梳理。通过阅读前辈的文章或者各种Issue,大概了解了 JS 的历史进程。以史为鉴,可以知兴替。此时不断成为历史,历史终将定论。

参考

  1. 各模块化使用的例子
  2. Require.js
  3. Sea.js
  4. UMD
  5. ES6 Module
  6. JavaScript模块化七日谈
  7. require.js模块化开发,并用r.js打包例子