no-extra-label

Disallow unnecessary labels

🔧

Some problems reported by this rule are automatically fixable by the --fix command line option

If a loop contains no nested loops or switches, labeling the loop is unnecessary.

A: while (a) {
    break A;
}
1
2
3

You can achieve the same result by removing the label and using break or continue without a label. Probably those labels would confuse developers because they expect labels to jump to further.

Rule Details

This rule is aimed at eliminating unnecessary labels.

Examples of incorrect code for this rule:

Open in Playground

/*eslint no-extra-label: "error"*/

A: while (a) {
    break A;
}

B: for (let i = 0; i < 10; ++i) {
    break B;
}

C: switch (a) {
    case 0:
        break C;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

Examples of correct code for this rule:

Open in Playground

/*eslint no-extra-label: "error"*/

while (a) {
    break;
}

for (let i = 0; i < 10; ++i) {
    break;
}

switch (a) {
    case 0:
        break;
}

A: {
    break A;
}

B: while (a) {
    while (b) {
        break B;
    }
}

C: switch (a) {
    case 0:
        while (b) {
            break C;
        }
        break;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

When Not To Use It

If you don’t want to be notified about usage of labels, then it’s safe to disable this rule.

Version

This rule was introduced in ESLint v2.0.0-rc.0.

Resources

Edit this page