Google JavaScript 編碼規範指南

JavaScript 是一種客戶端腳本語言, Google 的許多開源工程中都有用到它. 這份指南列出了編寫 JavaScript 時需要遵守的規則.

變量

當你沒有寫 var, 變量就會暴露在全局上下文中, 這樣很可能會和現有變量衝突. 另外, 如果沒有加上, 很難明確該變量的作用域是什麼, 變量也很可能像在局部作用域中, 很輕易地洩漏到 Document 或者 Window 中, 所以務必用 var 去聲明變量.

常量

常量的形式如: NAMES_LIKE_THIS, 使用大寫字符, 並用下劃線分隔. 你也可用 @const 標記來指明它是一個常量. 但請永遠不要使用 const 關鍵詞.

對於基本類型的常量, 只需轉換命名.

/**
* The number of seconds in a minute.
* @type {number}
*/
goog.example.SECONDS_IN_A_MINUTE = 60;

對於非基本類型, 使用 @const 標記.

/**
* The number of seconds in each of the given units.
* @type {Object.}
* @const 

*/
goog.example.SECONDS_TABLE = {
minute: 60,
hour: 60 * 60,
day: 60 * 60 * 24
}

這標記告訴編譯器它是常量.

至於關鍵詞 const, 因為 IE 不能識別, 所以不要使用.

分號

總是使用分號.

如果僅依靠語句間的隱式分隔, 有時會很麻煩. 你自己更能清楚哪裡是語句的起止.

而且有些情況下, 漏掉分號會很危險.

更多規範請參見：

http://alloyteam.github.io/JX/doc/specification/google-javascript.xml

閱讀更多 KeepWriting 的文章

關鍵字: 作用域 變量 腳本語言