JavascriptCodingStandard Javascript 代码规范

时间 2019-11-26

标签 javascriptcodingstandard javascript 代码规范栏目 JavaScript 繁體版

原文原文链接

规范理念

Any violation to this guide is allowed if it enhances readability.前端

全部的代码都要变成可供他人容易阅读的。json

--引用自Dojo Javascript 语法规范数组

规范详解

命名规范

必须使用 Tab 键进行代码缩进，以节约代码大小(建议设置编辑器的tab为4个空格的宽度)
接口风格

结构	规则	例如
类	驼峰式	ModuleClass()
公有方法	混合式	getPosition()
公有变量	混合式	frameStyle
常量	大写式	DEFAULT_FRAME_LAYOUT

其余建议风格，非必要

结构	规则
私有方法	混合，例子：mixedCase
私有变量	混合，例子：mixedCase
方法（method）参数	混合，例子：mixedCase, mixedCase
本地（local）变量	混合，例子：mixedCase, mixedCase

全部语句结束后，必须使用 ; 号结束
全部变量必须是有意义的英文，严厉禁止拼音
变量容许使用公认英文缩写
类命名必须是驼峰式
常量必须全部单词大写，而且每一个单词间加下划线
枚举类型时，枚举的命名必须有意义，枚举与枚举成员必须以驼峰式
常量和枚举必须在最前端定义，merge 时注意，必须把常量与枚举定义的文件放在文件列表的第一位
变量内的简写单词不能全大写XmlDocument strHtml
"on"只能用做事件的命名
函数开头必须是有意义的动词或动词短语
私有类的变量属性成员建议使用混合式命名，并前面下下划线
临时的全局变量放到一个全局的哈希表里，方便变量回收
全部全局变量必须初始化，尽可能少用全局变量
大括号前面不能有换行符
保留字以及特有的dom属性不能做为变量名

特殊命名约定

前面加 “is” 的变量名应该为布尔值，亦可以使用 “can” “has” “should”
前面加 ”str” 的变量名应该为字符串
前面加 “arr” 的变量名应该为数组
前面加 “num” 或 “count” 的变量名应该为数字
“o” 做为局部变量或参数，表示为Object
“e” 做为局部变量或参数，表示为Element
“evt” 做为局部变量或参数，表示为event
“err” 做为局部变量或参数，表示为error
重复变量建议使用 "i", "j", "k" （依次类推）等名称的变量(全世界公认)
能缩写的单词尽可能缩写
避免产生使人误解的布尔值 isNotNumber isNan
处理错误的变量，必须在后面跟着 “Error”
初始化用的函数必须使用 “init” 开头，若是一个页面只有初始化能够单独使用 init()
尽可能作有意义的代码折行，不要让一行代码过长。(HTML 字符串除外)
操做符建议使用空格隔开
函数调用和方法避免使用空白
逗号（,）建议使用空白隔开。
不容许频繁使用 previousSibling 和 nextSibling

词法结构

普通代码段应该看起来以下：

while(!isDone){
      doSomething();
      isDone = moreToDo();
}

if 语句应该看起来像这样：

if(someCondition){
        statements;
}elseif(someOtherCondition){
    statements;
}else{
    statements;
}

for 语句应该看起来像这样：

for(initialization; condition; update){
        statements;
}

while 语句应该看起来像这样：

while(!isDone){
        doSomething();
    isDone = moreToDo();
}

do ... while 语句应该看起来像这样：
```
do{
        statements;
}while(condition);
```

switch 语句应该看起来像这样：

switch(condition){
case ABC:
    statements;
    //  fallthrough
case DEF:
    statements;
    break;
default:
        statements;
    break;
}

try ... catch 语句应该看起来像这样：

try{
    statements;
}catch(ex){
    statements;
}finally{
    statements;
}

单行的 if - else，while 或者 for 语句也必须加入括号：

if(condition){ statement;}
while(condition){ statement;}
for(intialization; condition; update){ statement;}

注释规范

一些你不打算给其余人使用的函数，建议添加 @ignore 让文档输出时能够忽略这段注释
一些相关的功能相关的函数，建议加上@see Function 来对上下文作索引
对于一些函数不建议或则须要注意的使用方法，必须加上 @deprecated做为提醒
每一个js文件的文件头都必须包含 @fileoverview @author, 建议加上@version
每一个函数都必须使用JsDoc 来注释他的用意
每一个带参数的函数必须包含 @param
每一个有返回值的函数必须包含 @return
构造函数必须加上 @constructor
继承函数建议加上 @base 表示其继承于哪一个类
经常使用全局变量建议使用 JsDoc 的注释方式
通常的变量及局部变量才用 // 方式进行注释，建议在须要作注释的语句的上一行
其余详情请参考 JsDoc 注释方法

其余

String 优化

循环体内的字符串累加使用join方式。例如:
var r = [];
 for (var i=0;i<100;i++){
      r.push("hello");
 }
 var k = r.join("");

Switch 建议采用hash-table

switch 能够才用 Object代替例如:

var a = {
                "1":doAction1,
                "2":doAction2,
        }
        
        function doAction1(){
 
        }
 
        function doAction2(){
 
        }
 
        a[1]();

不建议使用eval

不推荐使用eval来执行脚本。除非用来解释json数据。

注意 IE 的内存泄露问题