Node.js 官方文檔中文版

本文檔翻譯自 <a rel="nofollow" href="https://nodejs.org/api/"">Node.js 官方文檔，適用于 V0.12.2。

本文檔從引用參考和概念兩個方面全面的解釋了 Node.js API。每個章節(jié)描述了一個模塊或高級概念。

一般情況下，屬性、方法參數(shù)，及事件都會列在主標題下的列表中。

每個 .html 文檔都有對應(yīng)的 .json ，它們包含相同的結(jié)構(gòu)化內(nèi)容。這些東西目前還是實驗性的，主要為各種集成開發(fā)環(huán)境（IDE）和開發(fā)工具提供便利。

每個 .html 和 .json 文件都和 doc/api/ 目錄下的 .markdown 文件相對應(yīng)。這些文檔使用 tools/doc/generate.js 程序生成。 HTML 模板位于 doc/template.html。

穩(wěn)定性標志

在文檔中，你會看到每個章節(jié)的穩(wěn)定性標志。Node.js API 還在改進中，成熟的部分會比其他章節(jié)值得信賴。經(jīng)過大量驗證和依賴的 API 是一般是不會變的。其他新增的，試驗性的，或被證明具有危險性的部分正重新設(shè)計。

穩(wěn)定性標志包括以下內(nèi)容:

穩(wěn)定性（Stability）: 0 - 拋棄
這部分內(nèi)容有問題，并已計劃改變。不要使用這些內(nèi)容，可能會引起警告。不要想什么向后兼容性了。

穩(wěn)定性（Stability）: 1 - 試驗
這部分內(nèi)容最近剛引進，將來的版本可能會改變也可能會被移除。你可以試試并提供反饋。如果你用到的部分對你來說非常重要，可以告訴 node 的核心團隊。

穩(wěn)定性（Stability）: 2 - 不穩(wěn)定
這部分 API 正在調(diào)整中，還沒在實際工作測試中達到滿意的程度。如果合理的話會保證向后兼容性。

穩(wěn)定性（Stability）: 3 - 穩(wěn)定
這部分 API 驗證過基本能令人滿意，但是清理底層代碼時可能會引起小的改變。保證向后的兼容性。

穩(wěn)定性（Stability）: 4 - API 凍結(jié)
這部分的 API 已經(jīng)在產(chǎn)品中廣泛試驗，不太可能被改變。

穩(wěn)定性（Stability）: 5 - 鎖定
除非發(fā)現(xiàn)了嚴重 bug，否則這部分代碼永遠不會改變。請不要對這部分內(nèi)容提出更改建議，否則會被拒絕。

JSON 輸出

穩(wěn)定性（Stability）: 1 - 試驗

每個通過 markdown 生成的 HTML 文件都有相應(yīng)的 JSON 文件。

這個特性從 v0.6.12 開始,是試驗性功能。