CommonJS规范
导读
内容大部分都是来源于 阮一峰老师的博客,做个搬运工加自己写一写。想看原文请移步CommonJS规范 -- JavaScript 标准参考教程(alpha)
1.了解
node应用由模块组成,采用的commonjs模块规范。每一个文件就是一个模块,拥有自己独立的作用域,变量,以及方法等,对其他的模块都不可见。CommonJS规范规定,每个模块内部,module变量代表当前模块。这个变量是一个对象,它的exports属性(即module.exports)是对外的接口。加载某个模块,其实是加载该模块的module.exports属性。require方法用于加载模块。
CommonJS模块的特点如下。
所有代码都运行在模块作用域,不会污染全局作用域。
模块可以多次加载,但是只会在第一次加载时运行一次,然后运行结果就被缓存了,以后再加载,就直接读取缓存结果。要想让模块再次运行,必须清除缓存。
模块加载的顺序,按照其在代码中出现的顺序。
2.module对象
1.module.exports属性
module.exports属性表示当前模块对外输出的接口,其他文件加载该模块,实际上就是读取module.exports变量。
2.exports变量
node为每一个模块提供了一个exports变量(可以说是一个对象),指向 module.exports。这相当于每个模块中都有一句这样的命令 var exports = module.exports;
这样,在对外输出时,可以在这个变量上添加方法。例如 exports.add = function (r){return Math.PI * r *r};注意:不能把exports直接指向一个值,这样就相当于切断了 exports 和module.exports 的关系。例如 exports=function(x){console.log(x)};
一个模块的对外接口,就是一个单一的值,不能使用exports输出,必须使用 module.exports输出。module.exports=function(x){console.log(x);};
用阮老师的话来说,这两个不好区分,那就放弃 exports,只用 module.exports 就好(手动机智)
3.AMD规范和commonJS规范
1.相同点:都是为了模块化。
2.不同点:AMD规范则是非同步加载模块,允许指定回调函数。CommonJS规范加载模块是同步的,也就是说,只有加载完成,才能执行后面的操作。
来,取个栗子。AMD规范
define(['package/lib'],function(lib){
functionfoo(){
lib.log('hello world!');
}
return{foo:foo};
});
再来个兼容的栗子,AMD规范允许输出的模块兼容CommonJS规范,这时define方法需要写成下面这样:
define(function(require,exports,module{
varsomeModule=require("someModule");
varanotherModule=require("anotherModule");
someModule.doTehAwesome();
anotherModule.doMoarAwesome();
exports.asplode=function({
someModule.doTehAwesome();
anotherModule.doMoarAwesome();
};
});
4.require命令
1.基本用法 require命令用于加载模块文件,相当于读入并执行一个js文件,然后返回该模块的exports对象,没有发现指定模块,则就会报错。
例如 example.js exports.name = 'tom';exports.age = 50;
在 同目录下的 demo.js 文件中 var example = require('./example.js');
console.log(example.name); // tom
console.log(example.age); // 50
或者 example.js function fn(){console.log(1)};
var name = 'tom'
module.exports = {fn:fn,name:name} 这里可以简写一下,es6的对象简写,key 和 value 一致,可以只写一个。 module.exports = {fn,name};
在 同目录下的 demo.js 文件中 var example = require('./example.js');
example.fn(); // 1
console.log(example.name); // tom
2.加载规则。真的好长,我直接搬 阮老师的。
根据参数的不同格式,require命令去不同路径寻找模块文件。
(1)如果参数字符串以“/”开头,则表示加载的是一个位于绝对路径的模块文件。比如,require('/home/marco/foo.js')将加载/home/marco/foo.js。
(2)如果参数字符串以“./”开头,则表示加载的是一个位于相对路径(跟当前执行脚本的位置相比)的模块文件。比如,require('./circle')将加载当前脚本同一目录的circle.js。
(3)如果参数字符串不以“./“或”/“开头,则表示加载的是一个默认提供的核心模块(位于Node的系统安装目录中),或者一个位于各级node_modules目录的已安装模块(全局安装或局部安装)。
举例来说,脚本/home/user/projects/foo.js执行了require('bar.js')命令,Node会依次搜索以下文件。
/usr/local/lib/node/bar.js
/home/user/projects/node_modules/bar.js
/home/user/node_modules/bar.js
/home/node_modules/bar.js
/node_modules/bar.js
这样设计的目的是,使得不同的模块可以将所依赖的模块本地化。
(4)如果参数字符串不以“./“或”/“开头,而且是一个路径,比如require('example-module/path/to/file'),则将先找到example-module的位置,然后再以它为参数,找到后续路径。
(5)如果指定的模块文件没有发现,Node会尝试为文件名添加.js、.json、.node后,再去搜索。.js件会以文本格式的JavaScript脚本文件解析,.json文件会以JSON格式的文本文件解析,.node文件会以编译后的二进制文件解析。
(6)如果想得到require命令加载的确切文件名,使用require.resolve()方法。
3.目录的加载规则 。。。
4.模块的缓存
第一次加载该模块,node会缓存该模块。再次加载,直接从缓存中取出该模块的module.exports属性。
require('./example.js');
require('./example.js').message="hello";
require('./example.js').message // "hello"
删除模块的缓存 缓存保存在require.cache中,可操作该属性进行删除
// 删除指定模块的缓存
delete require.cache[moduleName];
// 删除所有模块的缓存Object.keys(require.cache).forEach(function(key){deleterequire.cache[key];})
5.模块的循环加载
5.模块的加载机制
commonsJS的加载机制,输入的是被输出值的拷贝。也就是说,一旦输出一个值,模块内部的变化就影响不到这个值了。
require内部处理流程.......移步阮老师的教程吧。见顶部
是不是看完了,感觉和浏览器没啥关系,对,我也是这么觉得的。不过阮老师有一个文章很好的解释了。请移步浏览器加载 CommonJS 模块的原理与实现 - 阮一峰的网络日志
由于在 浏览器中不支持 commonjs的写法,故需要进行转化。可以了解一下这篇文章。如果不了解 npm 和 ES6 模块,那就看过来 - WEB前端 - 伯乐在线
commonjs,AMD,CMD规范 简单解析 浅析JS模块规范:AMD,CMD,CommonJS - 简书