Node.js学习笔记之CommonJS规范

CommonJS是Node.js使用的模块化标准,在CommonJS规范中,一个文件就是一个模块,模块具有单独的作用域,在模块内定义的变量、函数、类等都是私有的,对其他文件不可见。

exports定义模块

在CommonJS中使用exports定义模块。

// exapmle.js

const testVal = 100;

function test() {
    console.log(testVal);
}

module.exports.testVal = testVal;
module.exports.testFn = test;

上述代码执行后,会被封装成如下函数形式:

module对象

其中,module对象代表当前模块(Node内部提供了一个Module构造函数,所有模块都是Module实例)。module对象中包括:

  • children:Array,表示该模块要用到的其他模块,数组元素为其他模块的module对象
  • exports:Object,表示模块对外暴露的内容
  • filename:String,表示带绝对路径的文件名
  • id:String,表示文件的标识符, 通常是带有绝对路径的模块文件名
  • loaded:Boolean,返回一个布尔值,表示模块是否已经完成加载
  • parent:Object,表示调用该模块的模块
  • paths:Array,表示该模块的目录数组

exports对象

为了方便使用,Node提供了一个exports变量,指向module.exports。因此在定义输出接口时,可以向exports对象添加方法。

 exports.dosth = function() { ... }

// 等同于
module.exports.dosth = function() { ... }

// 另一种写法
function dosth() { ... }
module.exports.dosth = dosth;

在使用exports时必须要注意一点!!!就是不能修改exports的指向。

// 以下定义方式改变了exports的指向,exports对象会被当做普通的函数/对象
// 外部无法通过require获取

exports = function() { ... }

exports = {
  xx: 1
}

建议统一使用module.exports。

定义模块的几种方式

命名导出

暴露API的最基本方法,将所有要公开的值作为属性赋给exports对象。

exports.xxx = () => { ... }
导出函数

将整个module.exports变量重新分配给一个函数,主要优点是只暴露一个单一的功能,这为模块提供了一个明确的入口点,使其更容易理解和使用。

module.exports = () => { ... }
导出构造函数

导出构造函数的模块是导出函数的模块的特例。其不同之处在于,使用这种新模式,我们允许用户使用构造函数创建新的实例,但是我们也可以扩展其原型并创建新类(继承)。以下是此模式的示例:

// file logger.js
function Logger(name) {
  this.name = name;
}
Logger.prototype.log = function(message) {
  console.log(`[${this.name}] ${message}`);
};
module.exports = Logger;

我们通过以下方式使用上述模块:

// file main.js
const Logger = require('./logger');
const dbLogger = new Logger('DB');
dbLogger.log('...');

我们还可以使用ES6提供的class类实现上述代码。

导出实例

我们可以利用require()的缓存机制来轻松地定义具有从构造函数或工厂创建的状态的有状态实例,可以在不同模块之间共享。以下代码显示了此模式的示例:

//file logger.js
function Logger(name) {
  this.count = 0;
  this.name = name;
}
Logger.prototype.log = function(message) {
  this.count++;
  console.log('[' + this.name + '] ' + message);
};
module.exports = new Logger('DEFAULT');

这个新定义的模块可以这么使用:

// file main.js
const logger = require('./logger');
logger.log('This is an informational message');

因为模块被缓存,所以每个需要Logger模块的模块实际上总是会检索该对象的相同实例,从而共享它的状态,但并不保证整个应用程序的实例的唯一性。在分析解析算法时,一个模块可能会多次安装在应用程序的依赖关系树中。这导致了同一逻辑模块的多个实例,所有这些实例都运行在同一个Node.js应用程序的上下文中。

require加载模块

根据CommonJS规范的要求,Node.js使用内置的require命令加载模块。

const example = require('./example.js');

通过下面的函数来看看require函数究竟做了哪些事情:

const require = (moduleName) => {
  console.log(`Require invoked for module: ${moduleName}`);
  const id = require.resolve(moduleName);  // 输入函数名,返回模块的完整路径,该路径用于加载代码和标识模块
  // 是否命中缓存
  if (require.cache[id]) {
    return require.cache[id].exports;
  }
  // 定义module
  const module = {
    exports: {},
    id: id
  };
  // 新模块引入,存入缓存
  require.cache[id] = module;
  // 加载模块
  loadModule(id, module, require);
  // 返回导出的变量
  return module.exports;
};
require.cache = {};
require.resolve = (moduleName) => {
  /* 通过模块名作为参数resolve一个完整的模块 */
};

加载基本规则

  • 文件路径:/表示绝对路径,./表示相对路径,无/或./表示加载Node核心模块或node_modules中的第三方模块
  • 文件后缀:(无后缀)Node会尝试为文件添加.js,.json,.node后搜索解析
  • 使用require加载模块,加载时就会执行

加载缓存

Node在第一次加载某个模块时,会缓存该模块,以后再加载该模块,就直接从缓存取出module.exports属性。并且 CommonJS模块的加载机制是,输入的是被输出的值的拷贝。也就是说,一旦输出一个值,模块内部的变化就影响不到这个值。

// cache.js

var testVal = 100;

function test() {
  testVal++;
  console.log(testVal);
}
module.exports.testVal = testVal;
module.exports.testFn = test;

// main.js

const mod = require('./cache.js');
console.log(mod.testVal);  // 100
mod.testFn();  // 101
console.log(mod.testVal);  // 100

所有缓存的模块保存在require.cache之中,如果想删除模块的缓存,可以像下面这样写。

// 删除指定模块的缓存
delete require.cache[moduleName];

// 删除所有模块的缓存Object.keys(require.cache).forEach(function(key) {
delete require.cache[key];})

循环加载

如果发生模块的循环加载,即A加载B,B又加载A,则B将加载A的不完整版本。也就是说,一旦出现某个模块被循环加载,就只输出已执行的部分,还未执行的部分不会输出。

// modeA.js

module.exports.test = 'A';
const modB = require('./modB');
console.log('modA: ', modB.test); // modA: BB
module.exports.test = 'AA';

// modeB.js

module.exports.test = 'B';
const modA = require('./modA');
console.log('modB: ', modA.test); // modB: A
module.exports.test = 'BB';

// main.js

const modA = require('./modA');
const modB = require('./modB');
console.log(modA.test);  // 'AA'
console.log(modB.test);  // 'BB'

上述代码的执行过程:

  1. 执行node main.js运行main模块
  2. require模块A,开始执行模块A
  3. 模块A暴露出test值为A
  4. 模块A require模块B,开始执行模块B
  5. 模块B暴露出test值为B
  6. 模块B require模块A,此时直接取缓存,并不会继续执行模块A,因此输出modB: A
  7. 模块B覆盖test值为BB
  8. 模块B执行完毕之后,继续执行模块A,此时输出modA: BB
  9. 模块A覆盖test值为AA
  10. main模块require 模块B,直接取缓存
  11. 最后输出'AA','BB'
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 198,082评论 5 464
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,231评论 2 375
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 145,047评论 0 327
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,977评论 1 268
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,893评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,014评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,976评论 3 388
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,605评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,888评论 1 293
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,906评论 2 314
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,732评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,513评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,980评论 3 301
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,132评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,447评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,027评论 2 343
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,232评论 2 339

推荐阅读更多精彩内容