javascript程序编码规范

软件的长期价值直接源于其编码质量。在它的整个生命周期里,一个程序可能会被许多人阅读或修改。如果一个程序可以清晰的展现出它的结构和特征,那就能减少在以后对其进行修改时出错的可能性。

所有的javascript代码都是暴露给公众的。所以我们更应该保证其质量。

filename.js>应尽量放到body的后面。这样可以减少因为载入script而造成其他页面内容载入也被延迟的问题。也没有必要使用 language或者type属性。mime类型是由服务器而非scripttag来决定的。

缩进

避免每行超过80个字符。当一条语句一行写不下时,请考虑折行。在运算符号,最好是逗号后换行。在运算符后换行可以减少因为复制粘贴产生的错误被分号掩盖的几率。下一行应该缩进8个空格。

注释

及时地更新注释也很重要。错误的注释会让程序更加难以阅读和理解。

使用单行注释。块注释用于注释正式文档和无用代码。

变量声明

javascript没有块范围,所以在块里面定义变量很容易引起c/c++/java程序员们的误解。在函数的首部定义所有的变量。

所有的函数在使用前进行声明。 内函数的声明跟在var语句的后面。这样可以帮助判断哪些变量是在函数范围内的。

不要把_(下划线)作为变量名的第一个字符。它有时用来表示私有变量,但实际上javascript并没提供私有变量的功能。如果私有变量很重要, 那么使用私有成员的形式。应避免使用这种容易让人误解的命名习惯。

必须与 new共同使用的构造函数名应以大写字母开头。当new被省略时javascript不会有任何编译错误或运行错误抛出。忘记加 new时会让不好的事情发生(比如被当成一般的函数),所以大写构造函数名是我们来尽量避免这种情况发生的唯一办法。

每一行最多只包含一条语句。把;(分号)放到每条简单语句的结尾处。注意一个函数赋值或对象赋值语句也是赋值语句,应该以分号结尾。

复合语句是被包含在{ }(大括号)的语句序列。

• 被括起的语句必须多缩进四个空格。
• {(左大括号)应在复合语句其实行的结尾处。
• }(右大括号)应与{(左大括号)的那一行的开头对齐
• 大括号应该在所有复合语句中使用,即使只有一条语句,当它们是控制结构的一部分时, 比如一个if或者for语句。这样做可以避免以后添加语句时造成的错误。

标示

一条有返回值的return语句不要使用( )(括号)来括住返回值。如果返回表达式,则表达式应与return 关键字在同一行,以避免误加分号错误。

if 语句

第二种形式应用于对象中。object原型中的成员将会被包含在迭代器中。通过预先定义hasownproperty方法来区分真正的 object成员是个不错方法:

空格应在以下情况时使用:

• 跟在((左括号)后面的关键字应被一个空格隔开。

        while (true) {

• 函数参数与((左括号)之间不应该有空格。这能帮助区分关键字和函数调用。
• 所有的二元操作符,除了.(点) 和((左括号)和 [(左方括号)应用空格将其与操作数隔开。
• 一元操作符与其操作数之间不应有空格,除非操作符是个单词,比如typeof。
• 每个在控制部分,比如for 语句中的; (分号)后须跟一个空格。
• 每个,(逗号)后应跟一个空格。

另外的建议

{} 和[]

当成员名是一组有序的数字时使用数组来保存数据。当成员名是无规律的字符串或其他时使用对象来保存数据。

,(逗号)操作符

在javascript中块没有域。只有函数有域。不要使用块,除非在复合语句中。

赋值表达式

使用===和!==操作符会相对好点。==和!=操作符会进行类型强制转换。 特别是, 不要将==用于与错值比较( false,null,undefined,“”, 0,nan)。

令人迷惑的加号和减号