semi-spacing
强制分号前后保持一致的空格
🔧 可自动修复
此规则报告的一些问题可以通过 --fix
命令行 选项自动修复
JavaScript 允许你在分号前后放置不必要的空格。
禁止或强制分号周围的空格可以提高程序的可读性。
var a = "b" ;
var c = "d";var e = "f";
规则详情
此规则旨在强制分号周围的空格。此规则防止在表达式中的分号前使用空格。
此规则不检查以下情况的空格
-
如果分号是行中的第一个标记,则不检查分号后的空格。
-
如果分号在左括号(
(
或{
)之后,则不检查分号前的空格;如果分号在右括号()
或}
)之前,则不检查分号后的空格。这些空格由space-in-parens
或block-spacing
规则检查。 -
在具有空条件的 for 循环(
for(;;)
)中,不检查分号周围的空格。
选项
此规则接受一个选项,一个对象,它有两个键 before
和 after
,它们的值为布尔值 true
或 false
。如果 before
为 true
,则强制分号前有空格;如果为 false
,则禁止分号前有空格。如果 after
为 true
,则强制分号后有空格;如果为 false
,则禁止分号后有空格。after
选项仅在分号不在行尾时应用。
默认值是 {"before": false, "after": true}
。
"semi-spacing": ["error", {"before": false, "after": true}]
{"before": false, "after": true}
这是默认选项。它强制分号后有空格,并禁止分号前有空格。
此规则的 错误 代码示例
在 Playground 中打开
/*eslint semi-spacing: "error"*/
var foo;
var foovar bar;
throw new Error("error");
while (a) { break; }
for (i = 0; i < 10; i++) {}
for (i = 0 i < 10 i++) {}
此规则的 正确 代码示例
在 Playground 中打开
/*eslint semi-spacing: "error"*/
var foo;
var foo; var bar;
throw new Error("error");
while (a) { break; }
for (i = 0; i < 10; i++) {}
for (;;) {}
if (true) {;}
;foo();
{"before": true, "after": false}
此选项强制分号前有空格,并禁止分号后有空格。
使用 {"before": true, "after": false}
选项时,此规则的 错误 代码示例
在 Playground 中打开
/*eslint semi-spacing: ["error", { "before": true, "after": false }]*/
var foo
var foo ;var bar
throw new Error("error")
while (a) { break }
for (i = 0 i < 10 i++) {}
for (i = 0 i < 10 i++) {}
使用 {"before": true, "after": false}
选项时,此规则的 正确 代码示例
在 Playground 中打开
/*eslint semi-spacing: ["error", { "before": true, "after": false }]*/
var foo ;
var foo ;var bar ;
throw new Error("error") ;
while (a) {break ;}
for (i = 0 ;i < 10 ;i++) {}
何时不使用
如果您不关心分号前后空格的一致性,则可以关闭此规则。
相关规则
版本
此规则在 ESLint v0.16.0 中引入。