# 十.模块
前言
模块化的开发方式可以提高代码复用率,方便进行代码的管理。通常一个文件就是一个模块,有自己的作用域,只向外暴露特定的变量和函数。目前流行的 js 模块化规范有 CommonJS、AMD、CMD 以及 ES6 的模块系统
# 1.CommonJS
Node.js 是 commonJS 规范的主要实践者,它有四个重要的环境变量为模块化的实现提供支持:module
、exports
、require
、global
。实际使用时,用module.exports
定义当前模块对外输出的接口(不推荐直接用exports
),用require
加载模块。
- 定义模块
math.js
var basicNum = 0
function add(a, b) {
return a + b
}
module.exports = {
add: add,
basicNum: basicNum,
}
2
3
4
5
6
7
8
- 引用自定义的模块
var math=require('./math')
math.add(2,5)
//引用核心模块时,不需要带路径
var http=require('http')
http.createService(...).listen(3000)
2
3
4
5
commonJS 用同步的方式加载模块。在服务端,模块文件都存在本地磁盘,读取非常快,所以这样做不会有问题。但是在浏览器端,限制于网络原因,更合理的方案是使用异步加载。
# 2.AMD 和 require.js
AMD 规范采用异步方式加载模块,模块的加载不影响它后面语句的运行。所有依赖这个模块的语句,都定义在一个回调函数中,等加载完成之后,这个回调函数才会运行。这里介绍用 require.js 实现 AMD 规范的模块化:用require.config()
指定引用路径等,用define()
定义模块,用require()
加载模块。
首先我们需要引入 require.js 文件和一个入口文件 main.js。main.js 中配置require.config()
并规定项目中用到的基础模块。
//网页中引入require.js及main.js
;<script src="js/require.js" data-main="ja/main"></script>
//main.js入口文件/主模块
//首先用config()指定各模块路径和引用名
require.config({
baseUrl: "js/lib",
path: {
jquery: "jquery.min",
underscore: "underscroe.min",
},
})
//执行基本操作
require(["jquery", "underscore"], function ($, _) {
//some code here
})
2
3
4
5
6
7
8
9
10
11
12
13
14
15
引用模块的时候,我们将模块名放在[]
中作为require()
的第一参数;如果我们定义的模块本身也依赖其他模块,那就需要将它们放在[]
中作为define()
的第一参数
//定义math.js模块
define(function () {
var basicNum = 0
var add = function (x, y) {
return x + y
}
return {
add: add,
basicNum: basicNum,
}
})
//定义一个依赖underscore.js的模块
define(["underscore"], function (_) {
var classfy = function (list) {
_.countBy(list, function (num) {
return num > 30 ? "old" : "young"
})
}
return {
classify: classify,
}
})
//引用模块,将模块放在[]内
require(["jquery", "math"], function ($, math) {
var sum = math.add(10, 20)
$("#sum").html(sum)
})
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 3.CMD 和 sea.js
require.js 在申明依赖的模块时会在第一之间加载并执行模块内的代码:
define(["a", "b", "c", "d", "e", "f"], function (a, b, c, d, e, f) {
//等于在最前面声明并初始化了要用到的所有模块
if (false) {
b.foo()
}
})
2
3
4
5
6
CMD 是另一种 js 模块化方案,它与 AMD 很类似,不同点在于:AMD 推崇依赖前置,提前执行;CMD 推崇依赖就近,延迟执行。此规范在 sea.js 推广过程中产生的。
# 4.ES6 Module
ES6 在语言标准的层面上,实现了模块功能,而且实现的相当简单,旨在称为浏览器和服务器通用的解决方案。其模块功能主要由两个命令构成:export
和import
.export
命令用于规定模块的对外接口,import
命令用于输入其他模块提供的功能。
//定义模块
var basicNum = 0
var add = function (a, b) {
return a + b
}
export { basicNum, add }
//引用模块
import { basicNum, add } from "./math"
function test(ele) {
ele.textContent = add(99 + basicNum)
}
2
3
4
5
6
7
8
9
10
11
12
如上例所示,使用import
命令的时候,用户需要知道所要加载的变量名或函数名。其实 ES6 还提供了export default
命令,为模块指定默认输出,对应的import
语句不需要使用大括号.
//定义输出
export default { basicNum, add }
//引入
import math from "./math"
function test(ele) {
ele.textContent = math.add(99 + math.basicNum)
}
2
3
4
5
6
7
ES6 的模块不是对象,import
命令会被 JavaScript 引擎静态分析,在编译时就引入模块代码,而不是扎起代码运行时加载,所以无法实现条件加载。也正因为这个,使得静态分析成为可能。
# 5.模块间差异
# 5.1 数据使用方式
CommonJS 输出的是一个值的拷贝,ES6 Module 输出的是值的引用
- CommonJS 模块输出的是值的拷贝,也就是说,一旦输出一个值,模块内部的变化就影响不到这个值。
- ES6 模块的运行机制与 CommonJS 不一样。JS 引擎对脚本静态分析的时候,遇到模块加载命令
import
就会生成一个只读引用。等到脚本真正执行时,再根据这个只读引用,到被加载的吧、那个模块里面去取值。
# 5.2 输出时机
CommonJS 是运行时加载,ES6 Module 是编译时输出接口
运行时加载 CommonJS 模块就是对象,即在输入时是先加载整个模块,生成
一个对象在从这个对象上面读取方法,这种加载称为‘运行时加载’
编译时加载:ES6 模块不是对象,而是通过
export
命令显式指定输出的代码,import
静态命令的形式。即在import
时可以指定加载某个输出值,而不是加载整个模块,这个称为“编译时加载”CommonJS 加载的是一个对象,该对象只有在脚本运行完才会生成。而 ES6 模块不是对象,它的对外接口只是一种静态定义,在代码静态解析阶段就会生成
# 1.模块化
模块化是指把一个复杂的系统分解到多个模块以方便编码。
# 1.1 命名空间
开发网页通过命名空间的方式来组织代码
<script src="jquery.js"></script>
- 命名空间冲突,两个库可能使用同一个名称
- 无法合理地管理项目依赖和版本
- 无法方便的控制依赖的加载顺序
# 1.2 CommonJS
CommonJS
是一种使用广泛的JavaScript
模块化规范,核心思想是通过require
方法来同步加载依赖的其他模块,通过 module.exports 导出需要暴露的接口
# 1.2.1 用法
采用 CommonJS 导入导出时的代码如下:
// 导入
const someFun = require("./moduleA")
someFun()
// 导出
module.exports = someFunc
2
3
4
5
6
# 1.2.2 原理
a.js
let fs = require("fs")
let path = require("path")
let b = req("./b.js")
function req(mod) {
let filename = path.join(__dirname, mod)
let content = fs.readFileSync(filename, "utf8")
let fn = new Function(
"exports",
"require",
"module",
"__filename",
"__dirname",
content + "\n return modules.exports"
)
let module = {
exports: {},
}
return fn(module.exports, req, module, __filename, __dirname)
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
b.js
console.log("bbb")
exports.name = "zfpx"
2
# 1.3 AMD
AMD 也是一种 JavaScript 模块化规范,与 CommonJS 最大的不同在于它采用异步的方式去加载依赖的模块。AMD 规范主要是为了解决针对浏览器环境的模块化问题,最具代表性的实现是 requirejs。
AMD 的优点
- 可以在不转换代码的情况下直接在浏览器运行
- 可加载多个依赖
- 代码可运行在浏览器或 node.js 环境下
AMD 的缺点
- JavaScript 运行环境没有原生支持 AMD,需要先导入实现了 AMD 的库后才能正常使用。
# 1.3.1 用法
// 定义一个模块
define("a", [], function () {
return "a"
})
define("b", ["a"], function (a) {
return a + "b"
})
// 导入和使用
require(["b"], function (b) {
console.log(b)
})
2
3
4
5
6
7
8
9
10
11
# 1.3.2 原理
let factories = {}
function define(modName, dependencies, factory) {
factory.dependencies = dependencies
factories[modName] = factory
}
function require(modNames, callback) {
let loadedModNames = modNames.map(function (modName) {
let factory = factories[modName]
let dependencies = factory.dependencies
let exports
require(dependencies, function (...dependencyMods) {
exports = factory.apply(null, dependencyMods)
})
return exports
})
callback.apply(null, loadedModNames)
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 1.4 ES6 模块化
ES6 模块化是 ECMA 提出的 JavaScript 模块化规范,它在语言的层面上实现了模块化。浏览器厂商和 Node.js 都宣布要原生支持该规范。它将逐渐取代 CommonJS 和 AMD`规范,成为浏览器和服务器通用的模块解决方案。 采用 ES6 模块化导入及导出时的代码如下
// 导入
import { name } from "./person.js"
// 导出
export const name = "zfpx"
2
3
4
ES6 模块虽然是终极模块化方案,但它的缺点在于目前无法直接运行在大部分 JavaScript 运行环境下,必须通过工具转换成标准的 ES5 后才能正常运行
# 2.自动化构建
构建就是做这件事情,把源代码转换成发不到线上的可执行 JavaScript、CSS、HTML 代码,包括如下内容。
- 代码转换:ECMASCRIPT6 编译成 ECMASCRIPT5、LESS 编译成 CSS 等。
- 文件优化:压缩 JavaScript、CSS、HTML 代码,压缩合并图片等。
- 代码分割:提取多个页面的公共代码、提取首屏不需要执行部分的代码让其异步加载。
- 模块合并:在采用模块化的项目里会有很多个模块和文件,需要构建功能把模块分类合并成一个文件。
- 自动刷新:监听本地源代码的变化,自动重新构建、刷新浏览器。
- 代码校验:在代码提交到仓库前需要校验代码是否符合规范,以及单元测试是否通过。
- 自动发布:更新代码后,自动构建出线上发布代码并传输给发布系统。
# 3.webpack
Webpack 是一个打包模块化 JavaScript 的工具,在 Webpack 里一切文件皆模块,通过 Loader 转换文件,通过 Plugin 注入钩子,最后输出由多个模块组合成的文件。Webpack 专注于构建模块化项目。
一切文件:JavaScript、CSS、SCSS、图片、模板,在 Webpack 眼中都是一个个模块,这样的好处是能清晰的描述出各个模块之间的依赖关系,以方便 Webpack 对模块进行组合和打包。 经过 Webpack 的处理,最终会输出浏览器能使用的静态资源。