web前端JavaScript语法规范

Posted 2021-04-17 筑梦编程

采用小写驼峰式命名

// good
studentInfo

// bad
studentinfo
STUDENTINFO

常量命名方式

// good
const COL_NUM = 10;

// bad
const col_num = 10;

使用字面量

// good
const obj = {
    name:'faker'
}

// bad
let obj = {};
obj.name = 'faker';

函数参数使用解构

// good
function createPerson({ name, age }) {
 // ...
}
createPerson({
 name: 'Faker',
 age: 18,
});

// bad
function createPerson(name, age) {
 // ...
}

使用参数默认值

// good
function createMicrobrewery(name = 'faker') {
  // ...
}

// bad
function createMicrobrewery(name) {
  const breweryName = name || 'faker';
  // ...
}

函数式编程

// good
const programmerOutput = [
  {
    name: 'Uncle Bobby',
    linesOfCode: 500
  }, {
    name: 'Suzie Q',
    linesOfCode: 1500
  }, {
    name: 'Jimmy Gosling',
    linesOfCode: 150
  }, {
    name: 'Gracie Hopper',
    linesOfCode: 1000
  }
];
let totalOutput = programmerOutput
  .map(output => output.linesOfCode)
  .reduce((totalLines, lines) => totalLines + lines, 0)

// bad
const programmerOutput = [
  {
    name: 'Uncle Bobby',
    linesOfCode: 500
  }, {
    name: 'Suzie Q',
    linesOfCode: 1500
  }, {
    name: 'Jimmy Gosling',
    linesOfCode: 150
  }, {
    name: 'Gracie Hopper',
    linesOfCode: 1000
  }
];

let totalOutput = 0;

for (let i = 0; i < programmerOutput.length; i++) {
    totalOutput += programmerOutput[i].linesOfCode;
}

缩进

统一使用一个tab作为缩进

空格

二元运算符两侧必须有一个空格，一元运算符与操作对象之间不允许有空格。

用作代码块起始的左花括号 { 前必须有一个空格。

// good
var a = !arr.length;
a++;
a = b + c;

// good
if (condition) {
}

while (condition) {
}

function funcName() {
}

// bad
if (condition){
}

while (condition){
}

function funcName(){
}

禁止使用var，使用let、const代替

// good
let a = 123;

// bad
var a = 123;

js中使用单引号'，在dom中使用双引号"

// good
const str = '我是一个字符串';
<div className="div" />

// bad
const str = "我是一个字符串";
<div className='div' />

使用模板字符拼接字符串``

// good
const name = 'faker';
const str = `我叫${a}`;

// bad
const name = 'faker';
const str = '我叫' + a;

变量命名语义化

// good
const student = 'faker';

// bad
const a = 'faker';

注释

• 单行注释：必须独占一行。// 后跟一个空格，缩进与下一行被注释说明的代码一致

• 多行注释：避免使用 / ... / 这样的多行注释。有多行注释内容时，使用多个单行注释

• 文档化注释：为了便于代码阅读和自文档化，以下内容必须包含以 / *... / 形式的块注释中。

每个js文件在头部需要给出该页面的信息

// good
/*
 * 充值记录页面
 * @Author: Jiang
 * @Date: 2019-06-12 15:21:19
 * @Last Modified by: Jiang
 * @Last Modified time: 2019-07-23 10:55:51
*/

// bad
无任何注释

不要省略分号

// good
const student = 'faker';

// bad
const student = 'faker'

为了帮助大家学习前端，让学习变得轻松，高效！今天给大家分享一套教学资源，从最零基础开始的的html+CSS+javascript。jQuery，Ajax，node，angular框架等帮助大家在学习Web前端的道路上披荆斩棘

这套资源的领取方式如下：

*声明：本文于网络整理，版权归原作者所有，如来源信息有误或侵犯权益，请联系我们删除或授权事宜。

觉得不错，点个“在看”然后转发出去