Node.js 官方文檔中文版

本文檔翻譯自 Node.js 官方文檔，適用于 V0.12.2。

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

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

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

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

穩(wěn)定性標(biāo)志

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

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

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

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

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

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

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

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

JSON 輸出

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

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

這個(gè)特性從 v0.6.12 開(kāi)始,是試驗(yàn)性功能。