Enforce spacing around the * in generator functions (generator-star-spacing)

强制 generator 函数中 * 号周围有空格 (generator-star-spacing)

The --fix option on the command line can automatically fix some of the problems reported by this rule.

命令行中的 --fix 选项可以自动修复一些该规则报告的问题。

Generators are a new type of function in ECMAScript 6 that can return multiple values over time. These special functions are indicated by placing an * after the function keyword.

在 ECMAScript 6 中，Generators 是一个新的函数类型，随着时间的推移可以返回多个值。这些特殊的函数是在 function 关键字后放置一个 *。

Here is an example of a generator function:

以下是个 generator 函数的示例：

/*eslint-env es6*/

function* generator() {
    yield "44";
    yield "55";
}

This is also valid:

这个同样有效：

/*eslint-env es6*/

function *generator() {
    yield "44";
    yield "55";
}

This is valid as well:

这个也是有效的：

/*eslint-env es6*/

function * generator() {
    yield "44";
    yield "55";
}

To keep a sense of consistency when using generators this rule enforces a single position for the *.

为了保持使用 generators 函数的一致性，该规则对 * 强制设置一个单独的位置。

Rule Details

This rule aims to enforce spacing around the * of generator functions.

该规则旨在约束 generator 函数的 * 周围的空格。

Options

The rule takes one option, an object, which has two keys before and after having boolean values true or false.

该规则只有一个可选项，是个对象，有两个键before 和 after对应的值可以为true或false。

before enforces spacing between the * and the function keyword. If it is true, a space is required, otherwise spaces are disallowed.

In object literal shorthand methods, spacing before the * is not checked, as they lack a function keyword.
before 强制在 * 和 function 关键字之间有空格。如果设置为 true ，要求有空格，否则不允许有空格。在对象文本的缩写方法中，*之前的空格不会被检查，因为它们缺少 function 关键字。
after enforces spacing between the * and the function name (or the opening parenthesis for anonymous generator functions). If it is true, a space is required, otherwise spaces are disallowed.
after 强制在 * 和函数名之间有空格 (或匿名 generator 函数的左括号)。如果设置为 true，要求有空格，否则不允许有空格。

The default is {"before": true, "after": false}.

默认为 {"before": true, "after": false}。

An example configuration:

一个示例配置：

"generator-star-spacing": ["error", {"before": true, "after": false}]

And the option has shorthand as a string keyword:

这些选项可缩写为一个字符串关键字：

{"before": true, "after": false} → "before"
{"before": true, "after": false} → "before"
{"before": false, "after": true} → "after"
{"before": false, "after": true} → "after"
{"before": true, "after": true} → "both"
{"before": true, "after": true} → "both"
{"before": false, "after": false} → "neither"
{"before": false, "after": false} → "neither"

An example of shorthand configuration:

一个简写配置示例：

"generator-star-spacing": ["error", "after"]

Additionally, this rule allows further configurability via overrides per function type.

另外，该规则允许通过覆盖每个函数类型进行进一步配置。

named provides overrides for named functions
named 覆盖命名的函数
anonymous provides overrides for anonymous functions
anonymous 覆盖匿名函数
method provides overrides for class methods or property function shorthand
method 覆盖类方法或简写属性函数

An example of a configuration with overrides:

一个覆盖的配置示例：

"generator-star-spacing": ["error", {
    "before": false,
    "after": true,
    "anonymous": "neither",
    "method": {"before": true, "after": true}
}]

In the example configuration above, the top level “before” and “after” options define the default behavior of the rule, while the “anonymous” and “method” options override the default behavior. Overrides can be either an object with “before” and “after”, or a shorthand string as above.

在上面的配置示例中，顶层 “before” 和 “after” 选项定义该规则的默认行为，而 “anonymous” 和 “method” 选项覆盖默认行为。覆盖可以是带有 “before” 和 “after” 属性的对象，也可以是上面的简写字符串。

Examples

before

Examples of correct code for this rule with the "before" option:

选项 "before" 的正确代码示例：

/*eslint generator-star-spacing: ["error", {"before": true, "after": false}]*/
/*eslint-env es6*/

function *generator() {}

var anonymous = function *() {};

var shorthand = { *generator() {} };

after

Examples of correct code for this rule with the "after" option:

选项 "after" 的正确代码示例：

/*eslint generator-star-spacing: ["error", {"before": false, "after": true}]*/
/*eslint-env es6*/

function* generator() {}

var anonymous = function* () {};

var shorthand = { * generator() {} };

both

Examples of correct code for this rule with the "both" option:

选项 "both" 的正确代码示例：

/*eslint generator-star-spacing: ["error", {"before": true, "after": true}]*/
/*eslint-env es6*/

function * generator() {}

var anonymous = function * () {};

var shorthand = { * generator() {} };

neither

Examples of correct code for this rule with the "neither" option:

选项 "neither" 的正确代码示例：

/*eslint generator-star-spacing: ["error", {"before": false, "after": false}]*/
/*eslint-env es6*/

function*generator() {}

var anonymous = function*() {};

var shorthand = { *generator() {} };

Examples of incorrect code for this rule with overrides present:

带有覆盖的错误代码示例：

/*eslint generator-star-spacing: ["error", {
    "before": false,
    "after": true,
    "anonymous": "neither",
    "method": {"before": true, "after": true}
}]*/
/*eslint-env es6*/

function * generator() {}

var anonymous = function* () {};

var shorthand = { *generator() {} };

class Class { static* method() {} }

Examples of correct code for this rule with overrides present:

带有覆盖的正确代码示例：

/*eslint generator-star-spacing: ["error", {
    "before": false,
    "after": true,
    "anonymous": "neither",
    "method": {"before": true, "after": true}
}]*/
/*eslint-env es6*/

function* generator() {}

var anonymous = function*() {};

var shorthand = { * generator() {} };

class Class { static * method() {} }

When Not To Use It

If your project will not be using generators or you are not concerned with spacing consistency, you do not need this rule.

如果你的项目不使用 generators 或者你不关心空格的一致性，可以关闭此规则。

Version

This rule was introduced in ESLint 0.17.0.

该规则在 ESLint 0.17.0 中被引入。