Disallow Labeled Statements (no-labels)
Labeled statements in JavaScript are used in conjunction with break
and continue
to control flow around multiple loops. For example:
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.
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.
The following patterns are considered problems:
/*eslint no-labels: 2*/
label: /*error Unexpected labeled statement.*/
while(true) {
// ...
}
label: /*error Unexpected labeled statement.*/
while(true) {
break label; /*error Unexpected label in break statement.*/
}
label: /*error Unexpected labeled statement.*/
while(true) {
continue label; /*error Unexpected label in continue statement.*/
}
label: /*error Unexpected labeled statement.*/
switch (a) {
case 0:
break label; /*error Unexpected label in break statement.*/
}
label: /*error Unexpected labeled statement.*/
{
break label; /*error Unexpected label in break statement.*/
}
label: /*error Unexpected labeled statement.*/
if (a) {
break label; /*error Unexpected label in break statement.*/
}
The following patterns are not considered problems:
/*eslint no-labels: 2*/
var f = {
label: "foo"
};
while (true) {
break;
}
while (true) {
continue;
}
Options
{
"no-labels": [2, {"allowLoop": false, "allowSwitch": false}]
}
"allowLoop"
(boolean
, default isfalse
) - If this option was settrue
, this rule ignores labels which are sticking to loop statements."allowSwitch"
(boolean
, default isfalse
) - If this option was settrue
, this rule ignores labels which are sticking to switch statements.
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.
Those options allow us to use labels only with loop or switch statements.
The following patterns are considered problems when configured {"allowLoop": true, "allowSwitch": true}
:
label: /*error Unexpected labeled statement.*/
{
break label; /*error Unexpected label in break statement.*/
}
label: /*error Unexpected labeled statement.*/
if (a) {
break label; /*error Unexpected label in break statement.*/
}
The following patterns are not considered problems when configured {"allowLoop": true, "allowSwitch": true}
:
label:
while (true) {
break label;
}
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.
Related Rules
Version
This rule was introduced in ESLint 0.4.0.