Node.js文档学习笔记(1)
发布于 12 年前 作者 young40 6119 次浏览 最后一次编辑是 8 年前

1.文档基于源代码下doc/ap目录下的.markdown文件生成的.

2.文档有html和json两种格式, json格式是一种实验性质的文档, 目的是便于类似于IDE调用文档, 可以做些诸如代码提示等工作.

3.API的稳定级别. 0级, 废弃. 该API已知有问题, 计划更改, 不应该依赖该API, 应该不会向后兼容. 1级, 实验. 该API是新加的, 可能会被改变或者移除. 2级, 不稳定. 该API已经被确定, 但没有经过足够的测试, 会尽量做向后兼容. 3级, 稳定. 该API已经确认可靠, 可能会有小的更改, 会保证向后兼容. 4级, 高稳定性(冻结). 该API经过广泛在生产环境下测试, 基本上不会被更改. 5级, 最高稳定性(锁定). 该API除非有安全问题, 否则代码都不会该, 你也不要要求更改此API, 你的要求会被拒绝的.

4.全局作用域 可以用console.log(global)来打印出来全局的类. var var1 = 10; 在浏览器中var1是全局的. 在node中这个var1的作用域只是在当前模块(module), 所以不要担心var声明变量会污染全局.

常用的全局模块
process, console, Buffer, require, require.resolve(), require.cache, __filename,

__dirname, module, exports, 需要指出的是: require(), 并不是真正意义的全局类(函数??), 但每个module都包含(可以直接调用该类) require.resolve() 只分析并返回模块的路径, 并不加载该模块.查找模块的方法, 和require是一致的. require.cache 模块加载后会被缓存到这个对象, 如果删除了一个key value(模块?), 再次require的时候, 会重新加载该模块. __filename, __dirname 返回当前脚本的文件, 目录路径, 同样这两个也不是真正意义的全局变量

5.STDIO–console 稳定度:4级 console的用法和浏览器中类似 console.time 和 console.timeEnd可以联合使用可以方便地测量代码运行的时间.

6.Timers计时器 稳定度:5级 这个没啥好说的, setTimeout, setInterval, clearTimeout, clearInterval

7.Modules模块

稳定度:5级
这一块非常重要, 文档也非常长, 值得细读.
普通的加载就不说了, 一个require完事.

循环加载:
这个例子需要详细看下, 相关的机制, 要详细研究下源代码, 看英语看不太确切.

核心模块:
有几个核心模块(源代码lib/目录)被编译进了node, 如果你有一个自定义的文件和核心文件重名, 那么将加载核心模块而不是你自己的文件.所以文件名不要和核心文件重名.挺多的, 最好到node的代码里面看下.

文件模块:
如果你提供的名称(如hello)没有被精确匹配, node会尝试hello.js, hello.json, hello.node, js会被当成javascript文件, json会被当成json文件来解析, .node会被当成编译过的二进制文件使用dlopen来被加载.

加载位置, ‘/a.js’是绝对路径, ‘./b.js’ 是相对路径, 如果什么都不加, 并且不是核心模块, 那么会在node_modules来加载. 查找node_modules的规则是, 先在启动目录下查找, 如果查找不到那么依次寻找启动目录的父目录, 直到根目录. node采用这种模式来保证不同的模块能调用不同版本的一个模块, 而不产生冲突.

文件夹当做模块
如果require(‘./folder’); 那么node会试图查找package.json文件, 可以在package.json中定义一个main入口文件, node会加载他. 
如果package.json不存在, 那么node会试图加载index.js, index.node.

模块缓存
模块加载后会被缓存, 如果需要一段代码多次执行, 那么将其写成函数, 
还是没有理解循环依赖的时候的机制, 

小心缓存
因为上面提到的加载位置和加载顺序的问题, 那么同样的代码可能加载到的时候不同模块, 具体加载什么模块, 取决于require解析到的文件的路径

module对象
再次强调了下module对象不是一个全局对象,而是每个模块都包含的.

module.exports对象
关于module.exports是一个实例的这段没有看懂
不过module.exports赋值需要在模块加载的时候完成, 不能在回调函数中赋值. 否则就是undefined

module.require(id)
这段没有看懂
module还有其他一些属性, id, filename, loaded, parent, children

这里有段伪代码解释require.resolve()加载过程

全局模块加载:
这段主要是讲基于历史原因的全局模块的加载, 推荐将依赖放在node_modules目录下.

访问main module:
可以用require.main===module来判断当前模块是否是主模块, 既是采用node foo.js运行的还是 require(‘./foo.js’)来运行的

附录:包管理
包的依赖关系, 或许是很常见的问题, 回头再详细看. 
3 回复

写给自己看, 放在博客上的, 还是抛砖引玉, 希望能帮到一些朋友.

你可以在文档中搜索下Stability, 就知道了, http://nodejs.org/api/all.html

@young40

####以前确实很少关注Stability

回到顶部