@cowadev/standard
JavaScript Standard Style for Cowa Robot
Last updated 9 months ago by cowadev .
Repository · Original npm · Tarball · package.json
$ cnpm install @cowadev/standard 
SYNC missed versions from official npm registry.

Cowa Standard

Cowa项目使的JavaScript样式校验工具。在Standard JS的基础上,做了部分改动。

参考

注意

目前,由于ESLint的问题,对于?号操作符多行模式下的缩进会报错,需要使用/* eslint-disable /*来关闭相关校验,相关Issue

// this is the correct style, but `standard` will complain
/* eslint-disable */
const A = condition ?
  [
    1,
    2,
    3,
  ]
  :
  [
    4,
    5,
    6,
  ]
/* eslint-enable */

安装配置

使用husky配置@cowadev/standard作为pre-commit的钩子,推荐使用snazzy来美化输出。

yarn add -D husky
yarn add -D @cowadev/standard
yarn add -D snazzy
// vim package.json
{
  "scripts": {
    "precommit": "standard src/**/*.{js,jsx,vue} | snazzy"
  }
}

规则

standard的基础上,做了如下改动和修改。

  • 引号使用双引号而不是单引号(quotes

  • 数组,对象等如果跨行,末尾一定要有逗号comma-dangle

  • 函数名和函数参数之间不需要空格,除了asyncArrow

    // bad
    function a () {...}
    var a = function () {...}
    var b = async() => {...}
    
    // good
    function a() {...}
    var a = function() {...}
    var b = async () => {...}
    
  • 关键词前后都需要添加空格,除了ifswitchfor, catch后不需要添加空格。

    // bad
    if (...) {...}
    
    if() {
        ...
    } else{...}
    
    if() {
    
    }else {...}
    
    for () {
      ...
    }
    
    try {
    
    } catch (err) {
    
    }
    
    // good
    if() {...}
    
    if() {
    
    } else {...}
    
    for() {
      ...
    }
    
    try {
    
    } catch(err) {
    
    }
    
  • 默认使用eslint-babel作为parser,主要是默认parser目前不支持Class Property,而这个特性很有用。

  • ?:这两个操作符的换行规则比较特殊,如果比较短,那么全部在一行,如果比较长,?后跟一个换行,而:前后都跟上一个换行。

    var a = short ? var1 : var2
    var b = long ?
      var3
      :
      var4
    

全局变量

所有的全局变量应该都带有window前缀,除了documentnavigator。如果因为某些原因引入了全局变量,必须要告知Standard,否则将会报错。

  • 在文件顶部添加如下备注

    /* global var1, var2 */
    
  • package.json中添加如下内容

    "standard": {
      "globals": ["var1", "var2"]
    }
    

禁用检查

在某些情况下,需要禁用样式检查,具体请看ESLint disabling rules文档。简单来说,有两种方式。

  1. 使用eslint-disable-line注释来禁止检查某一行。
// 下面这一行不会进行样式检查
var a   = 100 // eslint-disable-line 
  1. 使用eslint-disableeslint-enable注释来禁止检查某一段区域的代码。
// 下面这段被注释包裹的代码都不会进行样式检查
/* eslint-disable */
var a   = 100
var b   = 200
...
/* eslint-enable */

Current Tags

  • 0.1.0                                ...           latest (9 months ago)

1 Versions

  • 0.1.0                                ...           9 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 4
Dev Dependencies (7)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |