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