javascript编码规范[原创]
一些命名规范书或js书命名规范章节,喜欢将命名规范跟语法混在一块例如:
1.使用“var”定义、初始化变量防止产生全局变量,多变量一块定义使用“,”(本身这种方式就很有争议)。
2.结尾必加“;”防止js执行效果跟想象中不一样。
3.判断两数相等使用“===”不要使用“==”。(实际上==会出问题情况很少发生,而js的语法章节也会提及建议使用“===”)
等等导致规范过于冗长,在我看来,命名规范不应太多,而是将实地编码中最常用到的列出即可。
研究过一些框架低层代码、看完《编写可维护的代码》整理出适合自己的js编码规范:
1.命名。
文字表述太繁琐,直接以下例子说明:
常量 AGE MY_AGE
一般变量 age my_name my_firstName
私有属性 _age _my_name _my_firstName
函数 init() changeName() changMyName()
私有方法 _init() _changeName() _changeMyName()
类 Sprite JumpSprite
2.方法、函数建议用动词:
Sprite.getTag();
Sprite.isLoad();
3.间隔、缩进。
间隔:操作符之间都是用空格间隔(除了特殊的负号“-”及自加自减)。
for (i = 0, len = items.length; i < len; i++){ doSomething(items[i]); }
缩进:虽然有些文章认为2格的空格缩进便于阅读跟代码转移,但实际上2行缩进在大部分IDE上很难操作
因为主流IDE的默认缩进都是4格,关于使用"Tab"导致的问题,使用IDE、web或本地格式化软件的
“格式化代码”即可解决。
4.行宽:
一行代码超过80行,不同的IDE有不同的提示:如editplus右下角有当前行数、列数提示
webStorm直接就有一条明显的线划分提示。
5.数组、对象定义:
定义数组不用new Array(),而是用"[]",定义对象不用new Object,而是用"{}"。
6.文件夹、文件命名:
文件夹使用蛇形命名法,如:syntax_highlighter, 文件使用驼峰命名法,如:shCore.css。(参考高亮插件:syntaxHighlighter的命名法)
附上某一500强公司的js规范:
1、禁止使用for-in语句枚举数组。(因为for in遍历,会遍历出多余的内容,如扩展的方法)。
2、禁止使用with语句。(容易出错、有安全隐患,且都有代替的代码实现)。
3、业务代码禁止使用eval。(同上,主要是防止XSS攻击)
禁止使用Function 构造器,它是另外一种形式的eval。
禁止给setTimeout 或者setInterval 传递字符串类型参数,否则这两个方法的行为就类似于eval。
4、禁止使用new Object(),必须用{}替代。(在Javascript里分配大量的new变量地址是一项很慢的操作,为了效率起见,你应该始终使用对象符号。)
5、禁止使用new Array(),必须用[]替代。(同上)