JavaScript 规范(ECMAScript)没有定义一套完善的能适用于大多数程序的标准库。CommonJS 提供了一套 JavaScript 标准库规范。Node 实现了 CommonJS 规范。
模块基础
在 Node 中,模块和文件是一一对应的。我们定义一个模块:
模块的加载
Node 会对加载过的模块进行缓冲,避免再次加载的开销:
多次加载模块 test.js
当加载文件没有后缀时,Node 会尝试添加后缀并加载:
1..js(JavaScript 源文件)
2..node(C/C++ 扩展模块)
3..json(JSON 文件)
模块主要有几类:
1.核心模块。核心模块已经被编译到了 Node 中,我们在其源码中的 lib 目录可以找到这些核心模块。常见的核心模块:net、http、fs 模块等
2.文件模块。文件模块通过一个相对或者绝对路径加载,例如我们上面看到的 circle.js
3.自定义模块。自定义模块位于 node_modules 目录中,我们通过 npm 安装的各种模块就放置在 node_modules 目录中
核心模块总是优先被加载,假如有一个自定义模块 http,那么加载时仍然会加载核心模块 http 而非自定义模块 http。在加载自定义模块时,首先查找当前目录下的 node_modules 目录,而后查找父目录下的 node_modules 目录,以此类推,直到根目录。
require 加载的模块不是一个文件,而是一个目录时,这样的目录被叫做包(package)。包中存在一个名为 package.json 的文件(包描述文件),例如:
其中 main 指出需要被加载的模块。如果包中不存在 package.json 或者 package.json 中未指定 main 模块,那么 Node 将会尝试加载 index.js、index.node、index.json。
在加载 JavaScript 模块时,被加载的模块被包裹在一个函数中:
每个 JavaScript 模块访问到的 module、exports、__filename、__dirname 等实际上是通过函数参数传递进来的。由于这种包裹,才使得模块的局部变量外部无法访问。但有时候也会出现让人难以理解的问题,例如:
test1.js
test2.js
加载这两个模块:
exports 作为参数传递给模块,我们通过 exports.x 自然可以给 exports 对象添加属性(或方法),但直接给 exports 赋值(例如,exports = x)仅仅是改变了形参而非实参的值,因此:
1.为 exports 添加属性时,使用 exports
2.为 exports 赋值时,使用 module.exports
包
按 CommonJS 的规范,一个完整的包应该包含有:
1.package.json 包描述文件
2.bin 二进制文件目录
3.lib JavaScript 代码目录
4.doc 文档目录
5.test 测试代码目录
NPM 是一个 Node 的一个包管理工具。常见用法:
查看命令的文档:
查看命令 install 的文档。
安装一个包:
移除一个包: