[情報] google javascript style guide

看板Ajax作者TonyQ (自立而後立人)時間11年前 (2013/10/30 12:29)推噓12(12推 0噓 15→)

留言27則, 7人參與討論串1/1

Google JavaScript Style Guide http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml 我摘一些重點，理由請自己讀原文＠變數一定要使用 var 定義＠常數使用大寫字母、底線分隔 NAMES_LIKE_THIS 使用 @const 註解＠總是補上分號＠可以使用巢狀函式 (nested function) ＠不要在 block 內定義函式如 if(check){ function test(){} } （註 block 不能定義 function 跟允許使用 nested function 沒有衝突， block 指的是除 function 以外的 {} 之間）＠可以使用 exception ( try-catch) ＠可以使用自定義 exception (custom exception) ( throw ) ＠ Standards features 總是優先使用標準 feature ＠不要為標準資料型態建立包裝 (Wrapper objects for primitive types) 如用 Boolean 封裝 true, false ，像這個例子就會造成問題 var x = new Boolean(false); if (x) { alert('hi'); // Shows 'hi'. } ＠不建議使用多層的 prototype 繼承鏈 (Multi-level prototype hierarchies) (但可以用 google closure 的 goog.inherits ) ＠物件成員跟方法的定義 Method and property definitions 建構式定義方式 /** @constructor */ function Foo() { this.bar = value; } 成員定義方式建議使用 Foo.prototype.bar = function() { /* ... */ }; ＠刪除物件屬性 (delete) 建議使用 this.foo = null. 形式用 Foo.prototype.dispose = function() { this.property_ = null; }; 但不要用 Foo.prototype.dispose = function() { delete this.property_; }; (因為前者效能比後者快很多）＠ Closures 可以使用，但要小心 (memory leak issue) ＠ eval 只用在讀取程式碼、 REPL (Read–eval–print loop) ＠ with ：不要使用＠ this ：只在建構子或物件函式裡面使用＠ for-in loop ：只用來作為列出所有 object 裡面的 key 使用（換言之，不能拿來 iterate 陣列）＠不要拿 array 來當 object 用＠不要用多行字串表達式 Multiline string literals 不要用類似這種的表達法 var str= "line1 \ line2 \ line3 "; ＠使用陣列跟物件表達式 ([],{}) Array and Object literals 比起 new Array() 、建議使用 [] 比起 new Object() 、建議使用 {} ＠不要修改內建物件的 prototype (Modifying prototypes of builtin objects) ＠不要使用 IE 專用判斷式(Internet Explorer's Conditional Comments) 不要用這種判斷式 /*@cc_on if(rule) { } */ ＠命名一般來說，使用 functionNamesLikeThis, function 名稱首字小寫、駱駝式 variableNamesLikeThis, 變數名稱也是首字小寫 ClassNamesLikeThis, 類別名稱首字大寫 EnumNamesLikeThis, Enum 首字大寫 methodNamesLikeThis, method 首字小寫 CONSTANT_VALUES_LIKE_THIS, 常數全大寫、底線分隔 foo.namespaceNamesLikeThis.bar, namespace 首字小寫 filenameslikethis.js js 檔名全小寫物件屬性與資料 private properties 的資料請用底線開頭 protected properties 資料不要用底線結尾（跟 public 一樣） /* .... 未完...下一篇待續 ....*/ -- 虛實之間的世界，反抗軍與啟蒙軍的交集帶著 Android 去旅行、去發現在身邊渾然不覺的另一個世界。全世界，都是我們的足跡與遊樂場。 ~ The world around you is not what it seems. ~ http://ingress.tw -- ※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 61.230.20.186

推

mrbigmouth

10/30 13:12, , 1^F

10/30 13:12, 1^F

推

s540421

10/30 13:16, , 2^F

10/30 13:16, 2^F

→

s540421

10/30 13:20, , 3^F

10/30 13:20, 3^F