1. 简介
ESLint 是一个语法规则和代码风格的检查工具,可以用来保证写出语法正确、风格统一的代码
ESLint是一个代码规范检查工具,主要是用来做项目编码规范检查
基本原理: 定义了很多规则,检查项目的代码一旦发现违背了某个规则就输出相应的提示信息有相应的配置, 可定制检查
2. 安装
npm install eslint --save-dev
3. 生成配置文件
使用eslint –init生成一个配置文件
{
<!--环境定义了预定义的全局变量-->
"env": {
<!--浏览器的全局变量-->
"browser": true,
<!--添加所有的 Jasmine 版本 1.3 和 2.0 的测试全局变量。-->
<!--Jasmine 是一款 JavaScript 测试框架,它不依赖于其他任何 JavaScript 组件。-->
"jasmine": true,
<!--Node.js 全局变量和 Node.js 作用域。-->
"node": true,
<!--Protractor 全局变量。-->
<!--angular自动化测试主要分:端到端测试和单元测试。-->
<!--端到端测试是从用户的角度出发,认为整个系统是个黑盒,只会有UI暴露给用户,主要是模仿人工操作测试。-->
<!--单元测试认为整个系统是白盒,可以用来测试服务,控制器,过滤器还有基础函数等。-->
<!--端到端测试使用protractor-->
"protractor": true,
<!--支持除模块外所有 ECMAScript 6 特性(该选项会自动设置 ecmaVersion 解析器选项为 6)。-->
"es6": true
},
<!--定义全局变量-->
<!--true代表允许重写、false代表不允许重写-->
"globals": {
"angular": true
},
<!--脚本解析切换为babel-eslint-->
<!--EsLint默认使用esprima做脚本解析,当然你也切换他,比如切换成babel-eslint解析-->
"parser": "babel-eslint",
<!--配置规则-->
<!--"off" 或 0 - 关闭规则-->
<!--"warn" 或 1 - 开启规则,使用警告级别的错误:warn (不会导致程序退出)-->
<!--"error" 或 2 - 开启规则,使用错误级别的错误:error (当被触发的时候,程序会退出)-->
"rules": {
<!--要求或禁止使用严格模式指令-->
"strict": 0,
<!--要求或禁止末尾逗号-->
"comma-dangle": 2,
<!--禁止条件表达式中出现赋值操作符-->
"no-cond-assign": 2,
<!--禁止在条件中使用常量表达式-->
"no-constant-condition": 2,
<!--禁止在正则表达式中使用控制字符-->
"no-control-regex": 2,
<!--禁用 debugger-->
"no-debugger": 2,
<!--禁止 function 定义中出现重名参数-->
"no-dupe-args": 2,
<!--禁止对象字面量中出现重复的 key-->
"no-dupe-keys": 2,
<!--禁止出现重复的 case 标签-->
"no-duplicate-case": 2,
<!--禁止在正则表达式中使用空字符集-->
"no-empty-character-class": 2,
<!--禁止对 catch 子句的参数重新赋值-->
"no-ex-assign": 2,
<!--禁止不必要的布尔转换-->
"no-extra-boolean-cast": 2,
<!--禁止不必要的括号-->
"no-extra-parens": 2,
<!--禁止不必要的分号-->
"no-extra-semi": 2,
<!--禁止对 function 声明重新赋值-->
"no-func-assign": 2,
<!--禁止在嵌套的块中出现变量声明或 function 声明-->
"no-inner-declarations": 2,
<!--禁止 RegExp 构造函数中存在无效的正则表达式字符串-->
"no-invalid-regexp": 2,
<!--禁止在字符串和注释之外不规则的空白-->
"no-irregular-whitespace": 2,
<!--禁止在 in 表达式中出现否定的左操作数-->
"no-negated-in-lhs": 2,
<!--禁止把全局对象作为函数调用-->
"no-obj-calls": 2,
<!--禁止正则表达式字面量中出现多个空格-->
"no-regex-spaces": 2,
<!--禁用稀疏数组-->
"no-sparse-arrays": 2,
<!--禁止出现令人困惑的多行表达式-->
"no-unexpected-multiline": 2,
<!--禁止在return、throw、continue 和 break 语句之后出现不可达代码-->
"no-unreachable": 2,
<!--要求使用 isNaN() 检查 NaN-->
"use-isnan": 2,
<!--强制 typeof 表达式与有效的字符串进行比较-->
"valid-typeof": 2,
<!--强制 getter 和 setter 在对象中成对出现-->
"accessor-pairs": 2,
<!--强制数组方法的回调函数中有 return 语句-->
"array-callback-return": 2,
<!--强制把变量的使用限制在其定义的作用域范围内-->
"block-scoped-var": 2,
<!--指定程序中允许的最大环路复杂度-->
"complexity": 2,
<!--强制所有控制语句使用一致的括号风格-->
"curly": [2, "multi-line"],
<!--要求 switch 语句中有 default 分支-->
"default-case": 2,
<!--强制尽可能地使用点号-->
"dot-notation": 2,
<!--要求使用 === 和 !==-->
"eqeqeq": 2,
<!--要求 for-in 循环中有一个 if 语句-->
"guard-for-in": 2,
<!--禁用 arguments.caller 或 arguments.callee-->
"no-caller": 2,
<!--不允许在 case 子句中使用词法声明-->
"no-case-declarations": 2,
<!--禁止除法操作符显式的出现在正则表达式开始的位置-->
"no-div-regex": 2,
<!--禁止 if 语句中 return 语句之后有 else 块-->
"no-else-return": 2,
<!--禁止使用空解构模式-->
"no-empty-pattern": 2,
<!--禁止在没有类型检查操作符的情况下与 null 进行比较-->
"no-eq-null": 2,
<!--禁用 eval()-->
"no-eval": 2,
<!--禁止扩展原生类型-->
"no-extend-native": 2,
<!--禁止不必要的 .bind() 调用-->
"no-extra-bind": 2,
<!--禁用不必要的标签-->
"no-extra-label": 2,
<!--禁止 case 语句落空-->
"no-fallthrough": 2,
<!--禁止数字字面量中使用前导和末尾小数点-->
"no-floating-decimal": 2,
<!--禁止使用短符号进行类型转换-->
"no-implicit-coercion": 2,
<!--禁止在全局范围内使用变量声明和 function 声明-->
"no-implicit-globals": 2,
<!--禁止使用类似 eval() 的方法-->
"no-implied-eval": 2,
<!--禁用 __iterator__ 属性-->
"no-iterator": 2,
<!--禁用标签语句-->
"no-labels": 2,
<!--禁用不必要的嵌套块-->
"no-lone-blocks": 2,
<!--禁止在循环中出现 function 声明和表达式-->
"no-loop-func": 2,
<!--禁止使用多个空格-->
"no-multi-spaces": 2,
<!--禁止使用多行字符串-->
"no-multi-str": 2,
<!--禁止对原生对象赋值-->
"no-native-reassign": 2,
<!--禁止在非赋值或条件语句中使用 new 操作符-->
"no-new": 2,
<!--禁止对 Function 对象使用 new 操作符-->
"no-new-func": 2,
<!--禁止对 String,Number 和 Boolean 使用 new 操作符-->
"no-new-wrappers": 2,
<!--禁用八进制字面量-->
"no-octal": 2,
<!--禁止在字符串中使用八进制转义序列-->
"no-octal-escape": 2,
<!--禁止对 function 的参数进行重新赋值-->
"no-param-reassign": 2,
<!--禁用 __proto__ 属性-->
"no-proto": 2,
<!--禁止多次声明同一变量-->
"no-redeclare": 2,
<!--禁止使用 javascript: url-->
"no-script-url": 2,
<!--禁止自我赋值-->
"no-self-assign": 2,
<!--禁用逗号操作符-->
"no-self-compare": 2,
<!--禁用逗号操作符-->
"no-sequences": 2,
<!--禁止抛出异常字面量-->
"no-throw-literal": 2,
<!--禁用一成不变的循环条件-->
"no-unmodified-loop-condition": 2,
<!--禁止不必要的 .call() 和 .apply()-->
"no-useless-call": 2,
<!--禁止不必要的字符串字面量或模板字面量的连接-->
"no-useless-concat": 2,
<!--禁用 void 操作符-->
"no-void": 2,
<!--禁止在注释中使用特定的警告术语-->
"no-warning-comments": 2,
<!--禁用 with 语句-->
"no-with": 2,
<!--强制在parseInt()使用基数参数-->
"radix": 2,
<!--要求所有的 var 声明出现在它们所在的作用域顶部-->
"vars-on-top": 2,
<!--要求 IIFE 使用括号括起来-->
"wrap-iife": 2,
<!--要求或禁止 “Yoda” 条件-->
"yoda": 2,
<!--禁止 catch 子句的参数与外层作用域中的变量同名-->
"no-catch-shadow": 2,
<!--禁止删除变量-->
"no-delete-var": 2,
<!--不允许标签与变量同名-->
"no-label-var": 2,
<!--禁用特定的全局变量-->
"no-restricted-globals": 2,
<!--禁止变量声明与外层作用域的变量同名-->
"no-shadow": 2,
<!--禁止将标识符定义为受限的名字-->
"no-shadow-restricted-names": 2,
//禁用未声明的变量,除非它们在 /*global */ 注释中被提到
"no-undef": 2,
<!--禁止将变量初始化为 undefined-->
"no-undef-init": 2,
<!--禁止将 undefined 作为标识符-->
"no-undefined": 2,
<!--禁止在变量定义之前使用它们-->
"no-use-before-define": [2, { "functions": false }],
<!--强制数组方括号中使用一致的空格-->
"array-bracket-spacing": 2,
<!--强制在单行代码块中使用一致的空格-->
"block-spacing": 2,
<!--强制在代码块中使用一致的大括号风格-->
"brace-style": 2,
<!--强制使用骆驼拼写法命名约定-->
"camelcase": 2,
<!--强制在逗号前后使用一致的空格-->
"comma-spacing": 2,
<!--强制使用一致的逗号风格-->
"comma-style": 2,
<!--强制在计算的属性的方括号中使用一致的空格-->
"computed-property-spacing": 2,
<!--当获取当前执行环境的上下文时,强制使用一致的命名-->
"consistent-this": [2, "self", "vm"],
<!--要求或禁止文件末尾存在空行-->
"eol-last": 2,
<!--强制一致地使用 function 声明或表达式-->
"func-style": [2, "declaration"],
<!--禁用指定的标识符-->
"id-blacklist": 2,
<!--要求标识符匹配一个指定的正则表达式-->
"id-match": 2,
<!--强制使用一致的缩进-->
"indent": [2, "tab"],
<!--强制在 JSX 属性中一致地使用双引号或单引号-->
"jsx-quotes": 2,
<!--强制在对象字面量的属性中键和值之间使用一致的间距-->
"key-spacing": 2,
<!--强制在关键字前后使用一致的空格-->
"keyword-spacing": 2,
<!--强制使用一致的换行风格-->
"linebreak-style": 2,
<!--强制可嵌套的块的最大深度-->
"max-depth": 2,
<!--强制回调函数最大嵌套深度-->
"max-nested-callbacks": 2,
<!--要求调用无参构造函数时有圆括号-->
"new-parens": 2,
<!--要求或禁止 var 声明语句后有一行空行-->
"newline-after-var": 2,
<!--newline-per-chained-call-->
"newline-per-chained-call": 2,
<!--禁用 Array 构造函数-->
"no-array-constructor": 2,
<!--禁用按位运算符-->
"no-bitwise": 2,
<!--禁用 continue 语句-->
"no-continue": 2,
<!--禁止在代码后使用内联注释-->
"no-inline-comments": 2,
<!--禁止空格和 tab 的混合缩进-->
"no-mixed-spaces-and-tabs": 2,
<!--禁止出现多行空行-->
"no-multiple-empty-lines": 2,
<!--禁用否定的表达式-->
"no-negated-condition": 2,
<!--禁用嵌套的三元表达式-->
"no-nested-ternary": 2,
<!--禁用 Object 的构造函数-->
"no-new-object": 2,
<!--禁用一元操作符 ++ 和 -- -->
"no-plusplus": 2,
<!--禁用特定的语法-->
"no-restricted-syntax": 2,
<!--禁止 function 标识符和括号之间出现空格-->
"no-spaced-func": 2,
<!--禁用行尾空格-->
"no-trailing-spaces": 2,
<!--禁止可以在有更简单的可替代的表达式时使用三元操作符-->
"no-unneeded-ternary": 2,
<!--禁止属性前有空白-->
"no-whitespace-before-property": 2,
<!--强制在大括号中使用一致的空格-->
"object-curly-spacing": 2,
<!--要求或禁止在可能的情况下使用简化的赋值操作符-->
"operator-assignment": 2,
<!--强制操作符使用一致的换行符-->
"operator-linebreak": 2,
<!--要求对象字面量属性名称用引号括起来-->
"quote-props": [2, "as-needed"],
<!--强制使用一致的反勾号、双引号或单引号-->
"quotes": [2, "single"],
<!--要求或禁止使用分号而不是 ASI-->
"semi": 2,
<!--强制分号之前和之后使用一致的空格-->
"semi-spacing": 2,
<!--强制在块之前使用一致的空格-->
"space-before-blocks": 2,
<!--强制在 function的左括号之前使用一致的空格-->
"space-before-function-paren": [2, { "anonymous": "always", "named": "never" }],
<!--强制在圆括号内使用一致的空格-->
"space-in-parens": 2,
<!--要求操作符周围有空格-->
"space-infix-ops": 2,
<!--要求操作符周围有空格-->
"space-unary-ops": 2,
<!--要求正则表达式被括号括起来-->
"wrap-regex": 2,
<!--强制箭头函数的箭头前后使用一致的空格-->
"arrow-spacing": 2,
<!--要求在构造函数中有 super() 的调用-->
"constructor-super": 2,
<!--强制 generator 函数中 * 号周围使用一致的空格-->
"generator-star-spacing": 2,
<!--禁止修改类声明的变量-->
"no-class-assign": 2,
<!--禁止不明用途的箭头-->
"no-confusing-arrow": 2,
<!--禁止修改 const 声明的变量-->
"no-const-assign": 2,
<!--禁止类成员中出现重复的名称-->
"no-dupe-class-members": 2,
<!--禁止在全局变量上使用new操作符-->
"no-new-symbol": 2,
<!--通过import导入时不允许指定模块-->
"no-restricted-imports": 2,
<!--禁止在构造函数中,在调用 super() 之前使用 this 或 super-->
"no-this-before-super": 2,
<!--禁用不必要的构造函数-->
"no-useless-constructor": 2,
<!--要求使用 let 或 const 而不是 var-->
"no-var": 2,
<!--要求或禁止对象字面量中方法和属性使用简写语法-->
"object-shorthand": 0,
<!--要求使用箭头函数作为回调-->
"prefer-arrow-callback": 2,
<!--要求使用 const 声明那些声明后不再被修改的变量-->
"prefer-const": 2,
<!--要求在合适的地方使用 Reflect 方法-->
"prefer-reflect": 0,
<!--要求使用扩展运算符而非 .apply()-->
"prefer-spread": 2,
<!--要求使用模板字面量而非字符串连接-->
"prefer-template": 2,
<!--要求 generator 函数内有 yield-->
"require-yield": 2,
<!--要求或禁止模板字符串中的嵌入表达式周围空格的使用-->
"template-curly-spacing": 2,
<!--要求或禁止模板字符串中的嵌入表达式周围空格的使用-->
"yield-star-spacing": 2,
"angular/log": 0
}
}