nodejs的模块

什么是模块?

node.js通过实现CommonJS的Modules/1.0标准引入了模块(module)概念,模块是Node.js的基本组成部分.一个node.js文件就是一个模块,也就是说文件和模块是一一对应的关系.这个文件可以是JavaScript代码,JSON或者编译过的C/C++扩展.

Node.js的模块分为两类,一类为原生(核心)模块,一类为文件模块。

在文件模块中,又分为3类模块。这三类文件模块以后缀来区分,Node.js会根据后缀名来决定加载方法。

  • .js。通过fs模块同步读取js文件并编译执行。
  • .node。通过C/C++进行编写的Addon。通过dlopen方法进行加载。
  • .json。读取json文件,调用JSON.parse解析加载。

Node提供了exports和require两个对象,其中exports是模块公开的接口,require用于从外部获取一个模块接口,即所获取模块的exports对象


require和exports

require

require函数用于在当前模块中加载和使用别的模块,传入一个模块名,返回一个模块导出对象。require方法接受以下几种参数的传递:

  • http、fs、path等。原生模块。
  • ./mod或../mod。相对路径的文件模块。
  • /a/mod,绝对路径的文件模块。
  • mod,非原生模块的文件模块。

exports

exports对象是当前模块的导出对象,用于导出模块公有方法和属性。别的模块通过require函数使用当前模块时得到的就是当前模块的exports对象。

module

通过module对象可以访问到当前模块的一些相关信息,但最多的用途是替换当前模块的导出对象

  • module.exports :{Object}类型,模块系统自动产生。

  • module.require(id)

id {String} 
Return: {Object} 已解析模块的 module.exports 
这个方法提供了一种像 require() 一样从最初的模块加载一个模块的方法。

    • module.id:{String}类型,用于区别模块的标识符。通常是完全解析后的文件名

    • module.filename:{String}类型,模块完全解析后的文件名。

    • module.loaded:{Boolean}类型,判断该模块是否加载完毕。

    • module.parent:{Module Object}类型,返回引入了本模块的其他模块。

    • module.children:{Array}类型,该模块所引入的其他子模块。

demo1 module.exports的使用

sayHello.js:
 

function sayHello() {
    console.log('hello');
}

module.exports = sayHello;

app.js:

var sayHello = require('./sayHello');
sayHello();

//hello

代码讲解:

定义一个sayHello模块,模块里定义了一个sayHello方法,通过替换当前模块exports对象的方式将sayHello方法导出。

在app.js中加载这个模块,得到的是一个函数,调用该函数,控制台打印hello。

demo2 匿名替换

sayWorld.js

module.exports = function () {
    console.log('world');
}

app.js

var sayWorld = require('./sayWorld');
sayWorld();

//world

代码讲解

与上面稍有不同,这次是匿名替换。

demo3 替换为字符串

不仅可以替换为方法,也可以替换为字符串等。

stringMsg.js

module.exports = 'i am a string msg!';

app.js

var string = require('./stringMsg');
console.log(string);

//i am a string msg!


demo4 exports导出多个变量

当要导出多个变量怎么办呢?这个时候替换当前模块对象的方法就不实用了,我们需要用到exports对象。

useExports.js
 

exports.a = function () {
    console.log('a exports');
}

exports.b = function () {
    console.log('b exports');
}

app.js

var useExports = require('./useExports');
useExports.a();
useExports.b();
//a exports
//b exports
当然,将useExports.js改成这样也是可以的:
module.exports.a = function () {
    console.log('a exports');
}

module.exports.b = function () {
    console.log('b exports');
}

下面通过gif图进行演示:

这里写图片描述

module.exports和exports在文章的最后会进行详细讲解。

模块初始化

一个模块中的JS代码仅在模块第一次被使用时执行一次,并在执行过程中初始化模块的导出对象。之后,缓存起来的导出对象被重复利用。

举个例子,count,js:

var i = 0;

function count() {
    return ++i;
}

exports.count = count;

  

app.js

var c1 = require('./count');
var c2 = require('./count');

console.log(c1.count());
console.log(c2.count());
console.log(co2.count());
//1
//2
//3

可以看到,count.js并没有因为被require了两次而初始化两次。

主模块

通过命令行参数传递给NodeJS以启动程序的模块被称为主模块。主模块负责调度组成整个程序的其它模块完成工作。例如通过以下命令启动程序时,我们刚刚一直使用的app.js就是主模块。

二进制模块

虽然一般我们使用JS编写模块,但NodeJS也支持使用C/C++编写二进制模块。编译好的二进制模块除了文件扩展名是.node外,和JS模块的使用方式相同。虽然二进制模块能使用操作系统提供的所有功能,拥有无限的潜能,但对于不熟悉C/C++的人而言编写过于困难,并且难以跨平台使用,因此本文不作讲解。

模块的加载优先级

由于Node.js中存在4类模块(原生模块和3种文件模块),尽管require方法极其简单,但是内部的加载却是十分复杂的,其加载优先级也各自不同,下面是require加载的逻辑图:

这里写图片描述

原生模块在Node.js源代码编译的时候编译进了二进制执行文件,加载的速度最快。另一类文件模块是动态加载的,加载速度比原生模块慢。但是Node.js对原生模块和文件模块都进行了缓存,于是在第二次require时,是不会有重复开销的。

exports与module.exports

这里可能是最容易混淆的地方了。

我们先来看一个例子:

modOne.js

exports.hello = function () {
    console.log("hello");
}

module.exports = function () {
    console.log('world');
}

app.js

var one = require('./modOne');

//one.hello(); //执行这句话会报错one.hello is not a function

one() //打印world

这是为什么呢?我们得先从exports 与module.exports 说起。

其实,exports 是module.exports的一个引用,exports 的地址指向module.exports。

而我们的modOne.js中通过module.exports = function的方式将module.exports给替换掉了。

而require方法所返回的是module.exports这个实实在在的对象,但是它已经被替换成了function,这就导致了exports指向了空,所以,你所定义的exports.hello是无效的。

用一个通俗易懂的例子来重新解释一遍。

比如你在电脑的D盘下新建了一个exports文本文档,然后你右键->发送到桌面快捷方式。

D盘就相当于nodejs中的module,这个exports文本文档就相当于nodejs中模块的exports对象,快捷方式就相当于nodejs中指向exports对象引用

D:/exportes.txt ==> module.exportes 
exportes.txt快捷方式 ==> exportes

然后,你看exportes.txt不爽,把它给删了,然后新建了一个word文档–exports.docx。

这个时候你桌面上的快捷方式就没用了,虽然也叫exports,但是你是访问不到这个新的word文件的。

对于nodejs也一样,当你把module.exportes对象覆盖了,换成了其他东西的时候,exportes这个引用就失效了。

同样,我们还可以用这个例子来理解为什么exportes也可以用来导出模块。

我们是这样使用exportes的:

exports.hello = function () {
    console.log("hello");
}

这段代码其实等同于:

module.exports.hello = function () {
    console.log("hello");
}

怎么理解呢。还是刚才的txt文件,这次没有删除。

D:/exportes.txt ==> module.exportes 
exportes.txt快捷方式 ==> exportes

你在桌面打开了exportes.txt快捷方式,然后在里面输入hello,然后保存,关闭。

你再打开D:/exportes.txt,你会发现你可以看到刚刚写的hello,你又在后面添加了一句“world”,保存关闭。

返回桌面,打开快捷方式,你会看到helloworld。

所以说你使用’exports.属性’和’module.exportes.属性’是等同的。

这也就能很好的解释下面这个问题了:

exports = function() {
   console.log('hello');
}

//这样写会报错

这样相当于把exprots这个引用覆盖掉了,你把txt文件的快捷方式改成docx的快捷方式还能打开原来的txt文件么?显然是不能的。

最后做一个总结:

当我们想让模块导出的是一个对象时, 使用exports 和 module.exports 都可以(但 exports 也不能重新覆盖为一个新的对象),而当我们想导出非对象接口时,就必须也只能覆盖 module.exports 。

一、首先搞清楚一个基本问题:

module.exportsexports是属于CommonJS模块规范!(不清楚commonjs?大神请这边逛一逛commonjs规范

exportexport default是属于ES6语法(不清楚ES6?大神请这边逛一逛ES6模块

同样importrequire分别属于ES6和CommonJS!

二、知道属于哪一块的语法了还有一个明确点:

module.exportsexports、exportexport default都是导出模块;

importrequire则是导入模块。

所以现在就不要弄混了,module.exports导出对应require导入,export导出对应import导入。

喂!等等,怎么才说到module.exports导出对应require导入,export导出对应import导入,那还有exports和export default呢!?那我们继续。

三、module.exportsexports的区别与联系

讲到这里就不得不稍微提一下模块化:

Node应用由模块组成,采用CommonJS模块规范。

根据这个规范,每个文件就是一个模块,有自己的作用域。在一个文件里面定义的变量、函数、类,都是私有的,对其他文件不可见。

CommonJS规范规定,每个模块内部,module变量代表当前模块。这个变量是一个对象,它的exports属性(即module.exports)是对外的接口。加载某个模块,其实是加载该模块的module.exports属性。

var x = 5;
var addX = function (value) {
  return value + x;
};
module.exports.x = x;
module.exports.addX = addX;

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

require方法用于加载模块。

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

console.log(example.x); // 5
console.log(example.addX(1)); // 6

看了刚刚这段commonjs规范上面的介绍可以知道以下区别与联系:

其实exports变量是指向module.exports,加载模块实际是加载该模块的module.exports。这等同在每个模块头部,有一行这样的命令。

var exports = module.exports;

于是我们可以直接在 exports 对象上添加方法,表示对外输出的接口,如同在module.exports上添加一样。注意,不能直接将exports变量指向一个值,因为这样等于切断了exports与module.exports的联系。

三、exportexport default的区别与联系

模块功能主要由:exportimport构成export导出模块的对外接口,import命令导入其他模块暴露的接口。

export其实和export default就是写法上面有点差别,一个是导出一个个单独接口,一个是默认导出一个整体接口。使用import命令的时候,用户需要知道所要加载的变量名或函数名,否则无法加载。这里就有一个简单写法不用去知道有哪些具体的暴露接口名,就用export default命令,为模块指定默认输出。

export可以这样写

// testA.js
var f = 'Miel';
var name = 'Jack';
var data= 1988;

export {f, name, data};

使用export命令定义了模块的对外接口以后,其他 JS 文件就可以通过import命令加载这个模块。

// main.js
import {f, name, data} from './testA';

export default可以这样写

// export-default.js
export default function () {
  console.log('foo');
}
// 或者写成

function foo() {
  console.log('foo');
}
export default foo;
// import-default.js
import customName from './export-default';
customName(); // 'foo'

下面比较一下export default和export 输出。

// 第一组
export default function car() { // 输出
  // ...
}

import car from 'car'; // 输入

// 第二组
export function car2() { // 输出
  // ...
};

import {car2} from 'car2'; // 输入

可以看到第一组是使用export default,import语句不需要使用大括号;
第二组使用export,对应的import语句需要使用大括号,一个模块只能有一个默认输出,所以export default只能使用一次。

四、import和require的区别与联系

看了上面其实已经清楚了,import和require是分别属于ES6和CommonJS的两种导入模块的语法而已

猜你喜欢

转载自blog.csdn.net/xiaojinguniang/article/details/83544174