间隔行注释
强制在行注释中的 //
后保持一致的空格。
一些风格指南要求或禁止在行注释的初始 //
后立即使用空格。//
后的空格使注释中的文本更易于阅读。另一方面,在不需在 //
后立即放置空格的情况下,更容易注释掉代码。
规则详情
此规则将强制执行行注释 //
开始后空格的一致性。
此规则接受两个参数。如果第一个参数是 "always"
,则 //
后必须至少有一个空格。如果是 "never"
,则后面不应有空格。默认值为 "always"
。
第二个参数是一个对象,其中包含一个键 "exceptions"
。该值为一个字符串模式数组,这些模式被视为规则的例外。需要注意的是,如果第一个参数为 "never"
,则忽略异常。无法混合使用异常。
此规则的错误代码示例
// When ["never"]
// This is a comment with a whitespace at the beginning
//When ["always"]
//This is a comment with no whitespace at the beginning
var foo = 5;
// When ["always",{"exceptions":["-","+"]}]
//------++++++++
// Comment block
//------++++++++
此规则的正确代码示例
// When ["always"]
// This is a comment with a whitespace at the beginning
var foo = 5;
//When ["never"]
//This is a comment with no whitespace at the beginning
var foo = 5;
// When ["always",{"exceptions":["-"]}]
//--------------
// Comment block
//--------------
// When ["always",{"exceptions":["-+"]}]
//-+-+-+-+-+-+-+
// Comment block
//-+-+-+-+-+-+-+
相关规则
版本
此规则在 ESLint v0.9.0 中引入,并在 v1.0.0-rc-1 中移除。