非常教程

Eslint参考手册

规则 | Rules

prefer-arrow-callback

在命令行上的--fix选项可以自动修复一些被这条规则反映的问题。

对于回调或函数参数,箭头函数可以成为函数表达式的有吸引力的替代方案。

例如,箭头函数会自动绑定到其周围的范围/上下文。这为显式绑定函数表达式以实现类似行为提供了 ES6之前的标准替代方案。

另外,箭头功能是:

  • 不详细,更容易推理。
  • 不管他们被调用的地点或时间,都可以词法绑定。

规则细节

此规则定位用作回调函数或函数参数的函数表达式。任何可以被箭头函数取代而不改变结果的错误都会产生。

以下示例被标记:

/* eslint prefer-arrow-callback: "error" */

foo(function(a) { return a; }); // ERROR
// prefer: foo(a => a)

foo(function() { return this.a; }.bind(this)); // ERROR
// prefer: foo(() => this.a)

箭头函数不会产生相同结果的实例将被忽略。

以下示例不会被标记:

/* eslint prefer-arrow-callback: "error" */
/* eslint-env es6 */

// arrow function callback
foo(a => a); // OK

// generator as callback
foo(function*() { yield; }); // OK

// function expression not used as callback or function argument
var foo = function foo(a) { return a; }; // OK

// unbound function expression callback
foo(function() { return this.a; }); // OK

// recursive named function callback
foo(function bar(n) { return n && n + bar(n - 1); }); // OK

选项

通过选项对象访问进一步控制此规则的行为。

默认: { allowNamedFunctions: false, allowUnboundThis: true }

allowNamedFunctions

默认情况下{ "allowNamedFunctions": false },该boolean选项禁止使用命名函数作为回调函数或函数参数。

通过允许使用命名函数而不受限制,将此值更改为将true反转此选项的行为。

{ "allowNamedFunctions": true } 不会标记以下示例:

/* eslint prefer-arrow-callback: [ "error", { "allowNamedFunctions": true } ] */

foo(function bar() {});

allowUnboundThis

默认情况下{ "allowUnboundThis": true },只要有问题的函数没有被明确绑定,该boolean选项就允许包含的函数表达式this被用作回调函数。

设置false为该选项时,禁止将函数表达式作为回调函数或函数参数完全使用,无一例外。

{ "allowUnboundThis": false } 举出以下例子:

/* eslint prefer-arrow-callback: [ "error", { "allowUnboundThis": false } ] */
/* eslint-env es6 */

foo(function() { this.a; });

foo(function() { (() => this); });

someArray.map(function(itm) { return this.doSomething(itm); }, someObject);

何时不使用它

  • 在尚未采用 ES6语言功能的环境中(ES3 / 5)。
  • 在 ES6 +环境中,允许在描述回调或函数参数时使用函数表达式。

进一步阅读

  • 有关ES6箭头函数的更多信息版本此规则是在 ESLint 1.2.0.Resources 中引入的
  • 规则资源
  • 文档资源

规则 | Rules相关

1.accessor-pairs
2.array-bracket-newline
3.array-bracket-spacing
4.array-callback-return
5.array-element-newline
6.arrow-body-style
7.arrow-parens
8.arrow-spacing
9.block-scoped-var
10.block-spacing
11.brace-style
12.callback-return
13.camelcase
14.capitalized-comments
15.class-methods-use-this
16.comma-dangle
17.comma-spacing
18.comma-style
19.complexity
20.computed-property-spacing
21.consistent-return
22.consistent-this
23.constructor-super
24.curly
25.default-case
26.dot-location
27.dot-notation
28.eol-last
29.eqeqeq
30.for-direction
31.func-call-spacing
32.func-name-matching
33.func-names
34.func-style
35.function-paren-newline
36.generator-star
37.generator-star-spacing
38.getter-return
39.global-require
40.global-strict
41.guard-for-in
42.handle-callback-err
43.id-blacklist
44.id-length
45.id-match
46.implicit-arrow-linebreak
47.indent
48.indent-legacy
49.init-declarations
50.jsx-quotes
51.key-spacing
52.keyword-spacing
53.line-comment-position
54.linebreak-style
55.lines-around-comment
56.lines-around-directive
57.lines-between-class-members
58.max-depth
59.max-len
60.max-lines
61.max-nested-callbacks
62.max-params
63.max-statements
64.max-statements-per-line
65.multiline-comment-style
66.multiline-ternary
67.new-cap
68.new-parens
69.newline-after-var
70.newline-before-return
71.newline-per-chained-call
72.no-alert
73.no-array-constructor
74.no-arrow-condition
75.no-await-in-loop
76.no-bitwise
77.no-buffer-constructor
78.no-caller
79.no-case-declarations
80.no-catch-shadow
81.no-class-assign
82.no-comma-dangle
83.no-compare-neg-zero
84.no-cond-assign
85.no-confusing-arrow
86.no-console
87.no-const-assign
88.no-constant-condition
89.no-continue
90.no-control-regex
91.no-debugger
92.no-delete-var
93.no-div-regex
94.no-dupe-args
95.no-dupe-class-members
96.no-dupe-keys
97.no-duplicate-case
98.no-duplicate-imports
99.no-else-return
100.no-empty
Eslint

ESLint 是一个代码规范和错误检查工具,有以下几个特性。所有东西都是可以插拔的。你可以调用任意的 rule api 或者 formatter api 去打包或者定义 rule or formatter。任意的 rule 都是独立的。没有特定的 coding style,你可以自己配置。

主页 https://eslint.org/
源码 https://github.com/eslint/eslint
发布版本 4.12.0

Eslint目录

1.指南 | Guide
2.规则 | Rules