关于此文档

关于此文档

该文档将从同时使用和概念两个方面详细的介绍 Node.js 的API，每个章节都将描述了一个内建模块或高级概念。

引用，数据类型，方法的参数以及事件提供的参数都将被详细的列举在标题的下方。

每个.html文件都有一个与之对应的.json文件，用结构化的方式表述相同的内容。这个功能是实验性的，用以加强对IDE的支持以及其余与文档相关的事务。

每个.html与.json文件都基于node资源树中doc/api/文件夹内相对应的.macrkdown文件。该文档使用tools/doc/generate.js程序生成的，其HTML模板为 doc/temlplate.html文件。

 

稳定性标识

在整篇文档中，咱们将看到章节的稳定性标识。Node.js的API是在不断变化的，随着它的成熟，其中一些部分必然比其余部分更加稳定。那些被证实可信赖的部分将不会被改变，而一些新的实验性的分支，或者有害的部分将被从新设计。

如下是稳定性标识：

稳定性 0 弃用的
这项功能被证实是有问题的，而且正在被计划修改。请不要依赖于它。使用这个功能将会致使一些警告以及一些不可预知的兼容性问题。

稳定性 1 实验性的
这样功能是最近被引进，有可能在未来的版本中被更改或移除。请试着使用它并提交反馈。若是他解决了一个对你来讲很是重要的用例，请告知node核心小组。

稳定性 2 不稳定的
这个API正在稳定的过程当中，可是尚未通过足够的测试证实其足够稳定。若是合理的话，向后的兼容性将被保留。

稳定性 3 稳定的
这个API被充分的证实，但在清理底层代码时将致使一些细微的变化。向后的兼容性将被保证。

稳定性 4 API冻结
这个API在产品中通过了大量的测试，并再也不准备改变。

稳定性 5 锁定的
除非发现了很是严重得缺陷，不然这段代码将再也不被更改。请不要建议更改这个部分，这些建议将被拒绝。

JSON输出

稳定性 1 实验性的

在markdown中，每个HTML文件都有一个与之对应的，拥有相同数据的json文件。

这个功能始于v0.6.12版本，是一个实验性的功能。