# 關(guān)于本文檔
本文檔的目標(biāo)是從參考和概念的角度全面解釋 Node.js 的 API,每章節(jié)描述一個內(nèi)置模塊或高級概念。
在某些情況下,屬性類型、方法參數(shù)以及事件處理過程(handler)參數(shù) 會被列在主標(biāo)題下的列表中。
每一個 `.html` 文件都對應(yīng)一份內(nèi)容相同的結(jié)構(gòu)化 `.json` 文檔。這個特性現(xiàn)在還是實驗性質(zhì)的,希望能夠為一些需要對文檔進行操作的IDE或者其他工具提供幫助。
每個 `.html` 和 `.json` 文件都是基于源碼的 `doc/api/` 目錄下的 `.markdown` 文件生成的。本文檔使用 `tools/doc/generate.js` 這個程序來生產(chǎn)的。 HTML 模板文件為 `doc/template.html`。
### 穩(wěn)定度
在文檔中,您可以了解每一個小節(jié)的穩(wěn)定性。Node.js的API會有一些小的改變,當(dāng)它成熟的時候,會有些部分相比另外一些來說更加可靠。有一部分接受過嚴(yán)格驗證,被大量依賴的API幾乎是不會改變的。也有一些是新增的、實驗性的或者因被證實具有危險性而在重新設(shè)計中。
穩(wěn)定度定義如下
~~~
穩(wěn)定度: 5 - 已鎖定
除非發(fā)現(xiàn)嚴(yán)重缺陷,該代碼不會被更改。請不要對此區(qū)域提出更改,更改提議將被拒絕。
~~~
### JSON 輸出
~~~
穩(wěn)定度: 1 - 實驗性
~~~
每個通過 markdown 生成的 HTML 文件都對應(yīng)于一個具有相同數(shù)據(jù)的 JSON 文件。
該特性引入于 node v0.6.12。當(dāng)前是測試性功能。
