关于 Node.js
本文档翻译自 Node.js 官方文档,适用于 V0.12.2。
本文档将从引用参考和概念两个方面来对Node.js API进行全面的解释,让你更加了解Node.js API。
Node.js官方文档的每个章节描述了一个内置模块或高级概念。
一般情况下,属性、方法参数,以及提供给事件处理程序的参数都会在主标题下的列表中详细说明。
每个.html
文档都有对应的.json
,它们包含相同的结构化内容。这些东西目前还是实验性的,主要为各种集成开发环境(IDE)和开发工具提供便利。
每个.html
和.json
文件都和doc/api/
目录下的.markdown
文件相对应。这些文档使用tools/doc/generate.js
程序生成。 HTML模板位于doc/template.html
。
稳定性标志
在文档中,你会看到每个章节的稳定性标志。Node.js API还在改进中,成熟的部分会比其他章节值得信赖。经过大量验证和依赖的API是一般是不会变的。其他新增的,试验性的,或被证明具有危险性的部分正被重新设计。
稳定性标志包括以下内容:
稳定性(Stability): 0 - 抛弃
这部分内容有问题,并已计划改变。不要使用这些内容,可能会引起警告。不要想什么向后兼容性了。
稳定性(Stability): 1 - 试验
这部分内容最近刚引进,将来的版本可能会改变也可能会被移除。你可以试试并提供反馈。如果你用到的部分对你来说非常重要,可以告诉 node 的核心团队。
稳定性(Stability): 2 - 不稳定
这部分 API 正在调整中,还没在实际工作测试中达到满意的程度。如果合理的话会保证向后兼容性。
稳定性(Stability): 3 - 稳定
这部分 API 验证过基本能令人满意,但是清理底层代码时可能会引起小的改变。保证向后的兼容性。
稳定性(Stability): 4 - API 冻结
这部分的 API 已经在产品中广泛试验,不太可能被改变。
稳定性(Stability): 5 - 锁定
除非发现了严重 bug,否则这部分代码永远不会改变。请不要对这部分内容提出更改建议,否则会被拒绝。
JSON 输出
稳定性(Stability): 1 - 试验
每个通过 markdown 生成的 HTML 文件都有相应的 JSON 文件。
这个特性从 v0.6.12 开始,是试验性功能。
更新日期 | 更新内容 |
---|---|
2015-04-21 | 第一版发布,翻译自 Node.js V0.12.2 官方文档 |