{"path":"93420","ref":"Text\/1_documentation.md","title":"关于本文档","content":"# 关于本文档\n\n本文档的目标是从参考和概念的角度全面解释 Node.js 的 API，每章节描述一个内置模块或高级概念。\n\n在某些情况下，属性类型、方法参数以及事件处理过程（handler）参数 会被列在主标题下的列表中。\n\n每一个 `.html` 文件都对应一份内容相同的结构化 `.json` 文档。这个特性现在还是实验性质的，希望能够为一些需要对文档进行操作的IDE或者其他工具提供帮助。\n\n每个 `.html` 和 `.json` 文件都是基于源码的 `doc\/api\/` 目录下的 `.markdown` 文件生成的。本文档使用 `tools\/doc\/generate.js` 这个程序来生产的。 HTML 模板文件为 `doc\/template.html`。\n\n### 稳定度\n\n在文档中，您可以了解每一个小节的稳定性。Node.js的API会有一些小的改变，当它成熟的时候，会有些部分相比另外一些来说更加可靠。有一部分接受过严格验证，被大量依赖的API几乎是不会改变的。也有一些是新增的、实验性的或者因被证实具有危险性而在重新设计中。\n\n稳定度定义如下\n\n~~~\n稳定度: 5 - 已锁定\r\n除非发现严重缺陷，该代码不会被更改。请不要对此区域提出更改，更改提议将被拒绝。\n~~~\n\n### JSON 输出\n\n~~~\n稳定度: 1 - 实验性\n~~~\n\n每个通过 markdown 生成的 HTML 文件都对应于一个具有相同数据的 JSON 文件。\n\n该特性引入于 node v0.6.12。当前是测试性功能。"}