Disallow Labeled Statements (no-labels)

禁用标签语句 (no-labels)

Labeled statements in JavaScript are used in conjunction with break and continue to control flow around multiple loops. For example:

JavaScript 中的标签语句连同 break 和 continue 一样用来控制循环流程。例如：

outer:
    while (true) {

        while (true) {
            break outer;
        }
    }

The break outer statement ensures that this code will not result in an infinite loop because control is returned to the next statement after the outer label was applied. If this statement was changed to be just break, control would flow back to the outer while statement and an infinite loop would result.

break outer 语句确保代码不会无限循环，因为应用 outer 标签之后，将会进入下一条语句。如果这个语句变为 break，控制流程会回到外层 while 语句，并会导致无限循环。

While convenient in some cases, labels tend to be used only rarely and are frowned upon by some as a remedial form of flow control that is more error prone and harder to understand.

虽然在某些情况下很方便，标签往往很少使用，很多人不赞成将标签作为一种复杂流程控制的补救措施。

Rule Details

This rule aims to eliminate the use of labeled statements in JavaScript. It will warn whenever a labeled statement is encountered and whenever break or continue are used with a label.

此规则旨在消除 JavaScript 中标签的使用。当遇到标签语句时，该规则将发出警告。

Examples of incorrect code for this rule:

错误 代码示例：

/*eslint no-labels: "error"*/

label:
    while(true) {
        // ...
    }

label:
    while(true) {
        break label;
    }

label:
    while(true) {
        continue label;
    }

label:
    switch (a) {
    case 0:
        break label;
    }

label:
    {
        break label;
    }

label:
    if (a) {
        break label;
    }

Examples of correct code for this rule:

正确 代码示例：

/*eslint no-labels: "error"*/

var f = {
    label: "foo"
};

while (true) {
    break;
}

while (true) {
    continue;
}

Options

The options allow labels with loop or switch statements:

以下选项允许在循环和 switch 语句中使用标签。

Actually labeled statements in JavaScript can be used with other than loop and switch statements. However, this way is ultra rare, not well-known, so this would be confusing developers.

实际上，在 JavaScript 中，标签语句可以用在除循环和 switch语句之外的地方。然而，这种方式是非常罕见的，所以会令开发中感到困惑。

allowLoop

Examples of correct code for the { "allowLoop": true } option:

选项 { "allowLoop": true } 的 正确 代码示例：

/*eslint no-labels: ["error", { "allowLoop": true }]*/

label:
    while (true) {
        break label;
    }

allowSwitch

Examples of correct code for the { "allowSwitch": true } option:

选项 { "allowSwitch": true } 的 正确 代码示例：

/*eslint no-labels: ["error", { "allowSwitch": true }]*/

label:
    switch (a) {
        case 0:
            break label;
    }

When Not To Use It

If you need to use labeled statements everywhere, then you can safely disable this rule.

如果你需要在任何地方都使用标签语句，你可以禁用此规则。

Version

This rule was introduced in ESLint 0.4.0.

该规则在 ESLint 0.4.0 中被引入。

Resources