ITPub博客

首页 > 应用开发 > Javascript > 学好WEB前端之javascript规范

学好WEB前端之javascript规范

原创 Javascript 作者:智云编程 时间:2019-06-29 14:31:04 0 删除 编辑

JavaScript 是一门弱类型语言,正因如此导致写法五花八门,这里整理了一些在编写代码时需要注意的事项

通用规范

文件编码

为了避免内容乱码,统一使用  UTF-8  编码保存。

在文件结尾处,保留一个空行。

代码检测

开启  eslint  代码规范和错误检查。

在严格模式模式下编码

'use strict';

类型规范

  • js 数据类型有 string、number、boolean、null、undefined、array、function 和 object 这几种,不同数据类型有不同的存储方式,也对应有不用的使用方法,对于数据赋值要注意以下几点

    • 初始值类型要明确
    • 不要随意变换类型
  • 类型检测 优先使用 typeof 。对象类型检测使用  instanceof 。null 或 undefined 的检测使用 == null。

  • 字符串开头和结束使用单引号  '...string...'

命名规范

  • 变量命名采用小驼峰命名,如:addUser password studentID

  • 常量命名采用单词所有字母大写,并用下划线分隔,如:FORM_NAME

  • 对于对象、函数、和实例采用小驼峰(camelCase)命名法

    // 对象
    let isObject = {};
    // 函数
    function isFun(){
     ...
    };
    // 实例
    let myBbj = new Object();
    
  • 对于类命名或者构造函数,采用大驼峰命名 User() DateBase()

    // 类
    class Point {
      ...
    };
    // 构造函数
    function User(options) {
      this.name = options.name;
    }
    let myBbj = new User({
      name: 'yup'
    });
    

代码规范

缩进

统一使用 两个空格缩进 ,不推荐使用 tap 缩进。

引号

统一使用 单引号 。

换行

每个独立语句结束后必须换行。

分号

不得省略语句结束的分号

代码块

使用花括号包裹所有的多行代码块。

单行 if 语句也必须使用花括号括住

// 推荐
if (true) {
  // TODO ...
}
// 不推荐
if (true) // TODO ...

使用全等符号

在等号表达式中使用类型严格的  === 和 !== 。使用 === 可以避免等于判断中隐式的类型转换。

// 推荐
if (age === 30) {
  // ......
}
// 不推荐
if (age == 30) {
  // ......
}

web前端开发直播教程Q-q-u-n: 767273102 ,内有免费开发工具,零基础,进阶视频教程,希望新手少走弯路

注释规范

单行注释

使用  //  作为单行注释。在评论对象上面另起一行使用单行注释。在注释内容前插入一个空格。

// 单行注释

多行注释

以 /* 开头, */ 结尾,注释内容前后加一个空格

/*
 * 第一行注释
 * 第二行注释
 */
/* 另外一种写法 */

方法注释

函数(方法)注释也是多行注释的一种,但是包含了特殊的注释要求,关键方法必须加注释。

/**
 * 方法功能描述
 * @param {*} 参数
 * @param {*} 参数
 * @param {*} 参数
 * @param {*} 参数
 * @return 返回值
 */

TODO 注释

使用 // TODO: 标注问题的解决方式。

function Calculator() {
  // TODO: total should be configurable by an options param
}



来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/69901074/viewspace-2649130/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论
从事前端5年,希望在贵平台分享前端技巧,知识心得

注册时间:2018-12-03

  • 博文量
    683
  • 访问量
    740633