js开发规范

#######################

 

1.缩进

[强制] 使用 4 个空格做为一个缩进层级，不允许使用 2 个空格 或 tab 字符。

[强制] switch中缩进2个空格

[强制] 要求分号前面不可以有空格，后面可以有空格

[强制] 要求语句块之前保留一个空格

[强制] 关键字和类似关键字前后保留一个空格

[强制] 要求运算符前后保留一个空格

[强制] 要求在一元操作符前后存在空格

[强制] 要求在注释前有一个空格

[强制] 要求逗号后面有一个空格，前面不允许有空格

[强制] 要求generator函数*前面空一格，后面不空格

[禁止] 不必要的空白

[禁止] 使用 空格 和 tab 混合缩进

[禁止] 出现多个空格

[禁止] 在对象字面量、解构赋值 和 import/export 说明符的花括号中使用空格

[禁止] 函数圆括号之前有一个空格

[禁止] 圆括号内的空格

 

2.换行

[强制] 要求文件末尾空一行

[强制] 要求声明变量后要空一行

[强制] 要求块内开头末尾空一行

[禁止] 出现多个空行

3.语句

[强制] 要求逗号在行尾出现

[强制] 要求if else while for do后面的代码块用{ }包围

[强制] 要求在每个语句的末尾有分号

[禁止] 空块语句

[禁止] 使用标签语句

[禁止] 在嵌套的语句块中出现function 声明

[禁止] 在运算关系的左侧使用布尔值，例如：if( !key in obj)

[禁止] 在返回语句中赋值

4.命名

[强制] 驼峰命名格式

[强制] 所有的常量都使用大写

[建议] boolean 类型的变量使用 is 或 has 开头。

5.注释

[强制] 文件：创建新的文件时，页头注释完整；包含

／*

   * url: 页面路由

   * author：开发人

   * date：开发时间

   * description：页面描述

*／

[强制] 注释与上一行之间必须空一行

[强制] 要求在注释前有一个空格

[强制] 函数/方法注释必须包含函数说明，有参数和返回值时必须使用注释标识

[强制] 对 Object 中各项的描述， 必须使用 @param 标识。

[强制] 类的属性或方法等成员信息使用 @public / @protected / @private 中的任意一个，指明可访问性。

[禁止] 注释和代码出现在同一行

[建议] 文件注释中可以用 @author 标识开发者信息。

[建议] 命名空间使用 @namespace 标识。

[建议] 使用 @class 标记类或构造函数。

[建议] 使用 @extends 标记类的继承信息。

6.变量

[强制] 函数中的变量在一起声明

[禁止]  会根据不同环境等情况，动态变化的值，禁止写死

[禁止] 重新声明原生对象

[禁止] 重新声明变量

[禁止] 重新定义关键字

[禁止] 初始化变量为undefined

7.条件判断

[强制] 判断条件最多有九次  

[禁止] 自身比较

[禁止] 在条件语句中出现赋值操作符，例如if(a = b)

[禁止] 在条件中使用常量表达式，例如：if(1)

[禁止] 在 else 前有 return,如果 if 块中包含了一个 return 语句，else 块就成了多余的了。可以将其内容移至块外。

[禁止] if 语句作为唯一语句出现在 else 语句块中 

[建议] 对于相同变量或表达式的多值条件，用 switch 代替 if

[建议] 在 Equality Expression 中使用类型严格的 ===。仅当判断 null 或 undefined 时，允许使用 == null

8.循环

[禁止] 循环中存在函数

[建议] 对循环内多次使用的不变值，在循环外用变量缓存。

9.类型

[强制] 要求调用 isNaN()检查 NaN

[强制] typeof 表达式与有效的字符串进行比较 

[建议] 类型检测优先使用 typeof。对象类型检测使用 instanceof。null 或 undefined 的检测使用 == null。

[建议] 转换成 string 时，使用 + ''

[建议] 转换成 number 时，通常使用 +

[建议] string 转换成 number，要转换的字符串结尾包含非数字并期望忽略时，使用 parseInt。

10.字符串

[强制] 字符串开头和结束使用单引号 '

[强制] 当使用 _dirname 和 _filename 时不允许字符串拼接，windows和unix路径分隔符不同，为了避免混淆并且创建正确的路径

[建议] 复杂的数据到视图字符串的转换过程，选用一种模板引擎

[建议] 使用``进行字符串拼接，尽量使用es6中的模板字符串对字符串进行拼接，避免使用加号+和join方法

11.对象

[强制] 定义getter，如果对象的setter存取器存在

[强制] 对象键值末尾不能带逗号

[强制] 以方括号取对象属性时，[之后和]之前不能带空格

[强制] object.key中'.'号应与属性在同一行

[强制] 对象字面量的key和冒号之间不允许有空格，冒号和value之间必须有空格

[强制] 使用对象字面量 {} 创建新 Object

[禁止] 对象字面量中出现重复的 key

[禁止] 扩展原生对象

[建议] 属性访问时，尽量使用 

12.数组

[强制] '['之后和']'之前不能带空格

[强制] 使用数组字面量 [] 创建新数组，除非想要创建的是指定长度的数组

[禁止] 稀疏数组，例如： arr = [1, 2, ,, 4]

13.函数

[强制] 如果函数包含err或者error作为参数，但是在函数内没有做错误的处理则会报错

[强制] 调用函数时括号前面不能有空格，也不能换行，只能 fun() 

[禁止] 使用 arguments.caller 和 arguments.callee，因为他们已经在es5中被弃用

[禁止] 在 function 定义中出现重复的参数

[禁止] 使用未声明的变量

[禁止] 存在未使用过的变量

[禁止] 存在未使用过的表达式

[禁止] 在return、throw、continue 和 break 语句之后出现不可达代码

[禁止] 使用Function构造函数，例如： var person = new function () {}

[禁止] 对函数参数再赋值

[建议] 一个函数的长度控制在 50 行以内

[建议] 一个函数的参数控制在 6 个以内

[建议] 通过 options 参数传递非数据输入型参数

 

14.其它最佳实践

[强制] 实例化构造函数时首字母必须大写

[强制] 要求调用首字母大写的函数时有 new 操作符

[强制] 实例化时必须要带括号

[强制] 操作符使用一致的换行符风格，例如：foo = 1
                                                                              + 2

[强制] 限制可以被抛出的异常

[禁止] 在块级作用域外访问块内定义的变量

[禁止] 存在alert、console、debugger

[禁止] 在正则表达式中使用控制字符

[禁止] 删除变量,例如 delete x

[禁止] 使用eval()

[禁止] 冗余的括号

[禁止] 不必要的分号

[禁止] case 语句落空

[禁止] 隐式的eval()

[禁止] 不规则的空白

[禁止] 出现多个空格

[禁止] 使用new产生副作用，例如：只new Person()但却不使用

[禁止] 对 String，Number 和 Boolean 使用 new 操作符

[禁止] 将全局对象当作函数进行调用，例如：var math = Math()

[禁止] 正则表达式字面量中出现多个空格

[禁止] 可以在有更简单的可替代的表达式时使用三元操作符

 

 

 

 

 

 

 

 

 

 

 

 

 

###############################