README

My JavaScript Standard Style

个人使用的 JS Linter，在 Standard JS 的基础上，做了部分改动。

安装配置

使用 husky 配置 @cjting/standard 作为 pre-commit 的钩子，推荐使用 snazzy 来生成输出。

yarn add -D husky @cjting/standard snazzy

添加如下内容到 package.json。

{
  "husky": {
    "hooks": {
      "pre-commit": "standard src/**/*.{js,jsx,vue} | snazzy"
    }
  }
}

使用 babel-eslint

首先，安装 babel-eslint，yarn add babel-eslint。

然后在 package.json 添加如下配置。

{
  "standard": {
    "parserOptions": {
      "parser": "babel-eslint",
      "sourceType": "module"
    }
  }
}

正常情况下，我们应该修改 parser属性，但是因为 eslint-plugin-vue 插件的限制，我们需要使用 parserOptions 选项。

规则

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

引号使用 双引号 而不是单引号（quotes）
数组，对象等如果跨行，末尾一定 要有逗号（comma-dangle）

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

// bad
function a () {...}
var a = function () {...}
var b = async() => {...}

// good
function a() {...}
var a = function() {...}
var b = async () => {...}

关键词前后都需要添加空格，除了 if，switch，for, catch 后不需要添加空格。

// bad
if (...) {...}

if() {
    ...
} else{...}

if() {

}else {...}

for () {
  ...
}

try {

} catch (err) {

}

// good
if() {...}

if() {

} else {...}

for() {
  ...
}

try {

} catch(err) {

}

? 和 : 这两个操作符的换行规则比较特殊，如果比较短，那么全部在一行，如果比较长，? 后跟一个换行，而 : 前后都跟上一个换行。
```
var a = short ? var1 : var2
var b = long ?
  var3
  :
  var4
```

全局变量

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

在文件顶部添加如下备注
```
/* global var1, var2 */
```

向 package.json 中添加如下内容

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

禁用检查

在某些情况下，需要禁用样式检查，具体请看 ESLint disabling rules文档。有如下几种方法。

使用 eslint-disable-line 注释来禁止检查某一行。

// 下面这一行不会进行样式检查
var a   = 100 // eslint-disable-line

使用 eslint-disable 和 eslint-enable 注释来禁止检查某一段区域的代码。

// 下面这段被注释包裹的代码都不会进行样式检查
/* eslint-disable */
var a   = 100
var b   = 200
...
/* eslint-enable */

在 pacakge.json 中配置 disabled 来禁止某项规则。

{
  "standard": {
    "disabled": [
      "quotes" // 整个项目都不会再检查引号规则
    ]
  }
}

@cjting/standard

Usage no npm install needed!