no-fallthrough
不允许陈述贯彻的示例(no-fallthrough)
"extends": "eslint:recommended"
配置文件中的属性启用此规则。
JavaScript中的switch语句是该语言中更容易出错的结构之一,这部分归功于从一种情况到另一种情况的“突破”能力。 例如:
switch(foo) {
case 1:
doSomething(
case 2:
doSomethingElse(
}
在这个例子中,如果foo
是1
,那么执行将在两个案例中流动,因为第一个会落到第二个。您可以通过使用来阻止这种情况break
,如下例所示:
switch(foo) {
case 1:
doSomething(
break;
case 2:
doSomethingElse(
}
当你不想要失败的时候,这很好,但如果失败是故意的,那么在语言中就没有办法指出这一点。使用与/falls?\s?through/i
正则表达式匹配的注释时,始终指示何时故意使用fallthrough被认为是最佳做法:
switch(foo) {
case 1:
doSomething(
// falls through
case 2:
doSomethingElse(
}
switch(foo) {
case 1:
doSomething(
// fall through
case 2:
doSomethingElse(
}
switch(foo) {
case 1:
doSomething(
// fallsthrough
case 2:
doSomethingElse(
}
在这个例子中,对于预期的行为没有混淆。很明显,第一个案件是要进入第二个案件。
规则细节
这条规则的目的是消除一个案件无意中掉到另一个案件。因此,它会标记没有标注评论的任何延期情况。
此规则的错误
代码示例:
/*eslint no-fallthrough: "error"*/
switch(foo) {
case 1:
doSomething(
case 2:
doSomething(
}
此规则的正确
代码示例:
/*eslint no-fallthrough: "error"*/
switch(foo) {
case 1:
doSomething(
break;
case 2:
doSomething(
}
function bar(foo) {
switch(foo) {
case 1:
doSomething(
return;
case 2:
doSomething(
}
}
switch(foo) {
case 1:
doSomething(
throw new Error("Boo!"
case 2:
doSomething(
}
switch(foo) {
case 1:
case 2:
doSomething(
}
switch(foo) {
case 1:
doSomething(
// falls through
case 2:
doSomething(
}
请注意,case
这些示例中的最后一条语句不会引起警告,因为没有任何内容会涉及到。
选项
该规则接受单个选项参数:
- 将该
commentPattern
选项设置为正则表达式字符串以更改针对有意坠落的评论的测试
commentPattern
选项{ "commentPattern": "break[\\s\\w]*omitted" }
的正确
代码示例:
/*eslint no-fallthrough: ["error", { "commentPattern": "break[\\s\\w]*omitted" }]*/
switch(foo) {
case 1:
doSomething(
// break omitted
case 2:
doSomething(
}
switch(foo) {
case 1:
doSomething(
// caution: break is omitted intentionally
default:
doSomething(
}
何时不使用
如果您不想强制每个case语句以throw,return,break或comment结尾,那么您可以安全地关闭此规则。
相关规则
- default-case
版本
该规则在ESLint 0.0.7中引入。