首页 > 其他分享 >js开发规范

js开发规范

时间:2023-04-09 19:22:57浏览次数:48  
标签:语句 建议 禁止 规范 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()

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

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

 

 

 

 

 

 

 

 

 

 

 

 

 

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

标签:语句,建议,禁止,规范,js,空格,开发,使用,强制
From: https://www.cnblogs.com/igoodful/p/17300841.html

相关文章

  • Web开发|XML Schema (XSD) 学习
    采用XSD建立教师、学生之间的关系。假设有两个实体“学生”和“教师”,一个学生可以有多个老师,一个老师也可以有多个学生,二者为多对多的关系。在XSD中描述多对多的关系可以使用XML元素的引用和复杂类型的组合,使用中间表(或连接表)来表示多对多关系。首先,我们定义“学生”和“教师”......
  • Web开发|AJAX学习
    IE|FireFox|Chrome,AJAX引擎运行方式的对比AJAX引擎的核心是XMLHttpRequest对象。而不同的浏览器创建XMLHttpRequest对象的方法是有差异的。IE浏览器使用ActiveXObject,而其他的浏览器使用名为XMLHttpRequest的JavaScript内建对象。XMLHttpRequest得到了所有现代浏览器较好的......
  • JS引擎(1):JS引擎擂台赛,JavaScript引擎的特征比较及术语科普
    上篇介绍过JavaScript引擎的历史,《JS引擎(0):起底各种JavaScript引擎群雄争霸之路》一些流行的JavaScript引擎SpiderMonkey ,BrendanEich在Netscape创建,由C/C++语言开发,可适配ECMA-262Edition5及其之后的标准版本Rhino,由NorrisBoyd(归属Netscape)创建,则是一个Ja......
  • JS引擎(2):Java平台上JavaScript引擎—Rhino/Nashorn概述
    可以后端开发的javascript引擎有ChromeV8基于C++java的Rhino引擎(JDK6被植入),Java8被替换为NashornRhino和Nashorn都是用Java实现的JavaScript引擎。它们自身都是普通的Java程序,运行在JVM上Rhino简介Rhino[ˈraɪnəʊ]是一种使用Java语言编写的JavaScript的......
  • JS引擎(0):JavaScript引擎群雄演义—起底JavaScript引擎
    JavaScript既是一个 面向过程的语言 又是一个 面向对象的语言。在JavaScript中,通过在运行时给空对象附加方法和属性来创建对象,与编译语言如C++和Java中常见的通过语法来定义类相反。对象构造后,它可以用作是创建相似对象的原型。JavaScript的动态特性包括运行时构造对......
  • 【小程序】微信小程序开发流程
    目录一、概述二、整体开发架构三、注册账号和安装开发工具1)注册账号1、注册方法2、选择注册的帐号类型3、填写邮箱和密码4、激活邮箱5、填写主体信息6、登录后台补充信息2)安装开发工具3)快速开始1、云开发和传统开发的区别2、云开发API分类3、AppID获取4、快速开始四、小程序登......
  • Vue开发规范
    ###############################单文件组件内容:<!--componentA.vue--><script>/*...*/</script><template>...</template><style>/*...*/</style>   组件相关:尽可能的减少watcher的数量尽量减少组件嵌套,递归渲染影响性能大量数据渲染导致卡顿,可以先渲染用户可见......
  • IDE 开发语言
    EmbarcaderoDelphi11的编译器IDE(IntegratedDevelopmentEnvironment)是使用ObjectPascal语言和DelphiVCL(VisualComponentLibrary)框架开发的。DelphiVCL是一个可视化组件库,它是Delphi的核心部分之一,用于构建Windows、macOS、iOS和Android应用程序的用户界面......
  • 使用eval的fromCharCode方法对js代码加壳
    在JavaScript中,使用eval函数可以将字符串作为代码来执行。这个特性可以被用来对JavaScript代码进行加壳以增加代码的安全性和保护知识产权。其中一个常用的方法是通过String.fromCharCode方法来创建一系列的ASCII字符,并将其拼接成一个包含加密代码的字符串。然后再通过eval函数执行......
  • 100天学会100个shell脚本-03-规范日期格式
    第二天[root@gbysh]#./03-规范日期格式.sh7141999Jul141999[root@gbysh]#./03-规范日期格式.sh7-14-1999Jul141999[root@gbysh]#./03-规范日期格式.sh7/14/1999Jul141999[root@gbysh]#./03-规范日期格式.sh123141999./03-规范日期格式.sh:Unknow......