no-unexpected-multiline
禁止使用令人困惑的多行表达式
✅ 推荐
在配置文件中使用来自 @eslint/js
的 recommended
配置会启用此规则。
在 JavaScript 中,由于自动分号插入 (ASI),分号通常是可选的。您可以使用semi规则要求或禁止使用分号。
ASI 的规则相对简单:正如 Isaac Schlueter 曾经描述的那样,换行符总是结束语句,就像分号一样,除了以下情况之一为真时
- 语句具有未闭合的括号、数组文字或对象文字,或以其他非有效方式结束语句。(例如,以
.
或,
结尾。) - 该行为
--
或++
(在这种情况下,它将递减/递增下一个标记。) - 它是
for()
、while()
、do
、if()
或else
,并且没有{
- 下一行以
[
、(
、+
、*
、/
、-
、,
、.
或其他一些二元运算符开头,该运算符只能在单个表达式中的两个标记之间找到。
在换行符不结束语句的例外情况下,省略分号的输入错误会导致两行不相关的连续行被解释为一个表达式。特别是对于没有分号的编码风格,读者可能会忽略错误。尽管语法上是正确的,但代码在执行时可能会抛出异常。
规则详细信息
此规则禁止使用令人困惑的多行表达式,其中换行符看起来像是结束语句,但实际上并非如此。
此规则的不正确代码示例
在游乐场中打开
/*eslint no-unexpected-multiline: "error"*/
var foo = bar
1 || 2).baz();
var hello = 'world'
1, 2, 3].forEach(addNumber);
let x = function() {}
hello`
let y = function() {}
y
hello`
let z = foo
regex/g.test(bar)
此规则的正确代码示例
在游乐场中打开
/*eslint no-unexpected-multiline: "error"*/
var foo = bar;
(1 || 2).baz();
var foo = bar
;(1 || 2).baz()
var hello = 'world';
[1, 2, 3].forEach(addNumber);
var hello = 'world'
void [1, 2, 3].forEach(addNumber);
let x = function() {};
`hello`
let tag = function() {}
tag `hello`
何时不使用它
如果您确信不会意外地引入这样的代码,可以关闭此规则。
请注意,被认为是问题的模式不会被semi规则标记。
相关规则
版本
此规则是在 ESLint v0.24.0 中引入的。