javascript编码规范

《javascript编码规范》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、AsiaInfo项目管理文档移动客户事业部编码规范软件规范编写编写时间审批审批时间文档版本亚信科技（中国）有限公司版权所有文档中的全部内容属亚信科技（中国）有限公司所有，未经允许，不可全部或部分发表、复制、使用于任何目的。文档修订摘要日期修订号描述著者审阅者日期2014-08-051建立亚信科技（中国）有限公司版权所有文档中的全部内容属亚信科技（中国）有限公司所有，未经允许，不可全部或部分发表、复制、使用于任何目的。目录1.1.编制说明01.1.适用范围01.2.引用文档02.1.属性和方法02.2.方法和函数参数02.3.Getters和Set

2、ters12.4.命名空间12.5.文件名33.1.自定义toString()方法33.2.延迟初始化43.3.代码格式43.3.1.大括号43.3.2.圆括号43.3.3.数组和对象的初始化43.3.4.函数声明53.3.5.函数参数63.3.6.匿名函数73.3.7.更多的缩进73.3.8.复合语句83.3.9.空行83.3.10.二元和三元操作符84.1.JSDoc缩进94.2.JSDoc中的HTML94.3.顶层/文件注释104.4.类注释114.5.方法与函数的注释114.6.属性注释125.1.变量125.2.常量135.3.分号13

3、5.4.块内函数声明145.5.标准特性145.6.封装基本类型155.7.方法/属性定义155.8.Delete155.9.闭包165.10.作用域(私有域和保护域)165.11.eval()185.12.with(){}195.13.This195.14.for-in循环19265.15.字符串205.16.多行字符串205.17.Array和Object直接量215.18.内置对象的原型225.19.IE下的条件注释225.20.True和False布尔表达式225.21.条件(三元)操作符(?:)235.22.&&和

4、

5、235.23.遍历

6、NodeList248.1.ECMAScript258.2.闭包25261.概述1.1.编制说明1.1.适用范围1.2.引用文档《GoogleJavaScriptStyleGuide》2.命名通常命名的格式为：函数、变量、方法名采用首字母小写，其余单词首字母大写的格式如： functionNamesLikeThis、variableNamesLikeThis、methodNamesLikeThis。 类名、枚举类名采用每个单词首字母全部大写的格式：ClassNamesLikeThis，EnumNamesLikeThis。静态变量采用全大写并以下划

7、线分割单词的方式： SYMBOLIC_CONSTANTS_LIKE_THIS。2.1.属性和方法Ø规则1)文件或类中的私有属性、变量和方法名应该以下划线“_”开头。2)保护属性、变量和方法名不需要下划线开头，和公共变量名一样。2.2.方法和函数参数Ø建议1)函数的参数个数不固定时，应该在最后添加一个名为 var_args的参数。也可以使用 arguments数组。2)可选和可变参数应该在@param 注释中说明清楚。虽然这个规定对编译器没有任何影响，但还是请尽量遵守。3)可选参数以 opt_ 开头。261.1.Getters和SettersØ规则

8、getters和setters并不是必要的。但只要使用它们了，就请将getters命名成 getFoo() 形式，将setters命名成 setFoo(value) 形式。(对于布尔类型的getters，使用 isFoo() 也可)1.2.命名空间JavaScript不支持包和命名空间。不容易发现和调试全局命名的冲突，多个系统集成时还可能因为命名冲突导致很严重的问题。为了提高JavaScript代码复用率，我们遵循下面的约定以避免冲突。Ø规则1)为全局代码使用命名空间在全局作用域上，使用一个唯一的，与工程/库相关的名字作为前缀标识。比如：工程是“

9、ProjectSloth”，那么命名空间前缀可取为 sloth.*。varsloth={};sloth.sleep=function(){...};许多JavaScript库，包括 theClosureLibrary Dojotoolkit 提供了声明命名空间的函数。比如:Goog.provide('sloth');sloth.sleep=function(){...};2)外部代码和内部代码使用不同的命名空间“外部代码”是指来自于本地工程代码体系的外部，可以独立编译。内外部命名应该严格保持独立。如：使用了一个外部库，它的所有对象都在 foo.

10、hats.* 下，那么本地工程的代码不能在foo.hats.*下命名，因为很有可能和它的命名冲突。foo.require('foo.ha