space-before-function-parentheses
空格之前的函数括号:在函数定义中打开括号之前强制执行一致的间距
这条规则在ESLint v1.0中被删除
,并被space-before-function-paren规则取代
。为了与其他规则的名称保持一致,规则的名称从“parentheses”更改为“paren”。
格式化函数时,函数名称或function
关键字与开始参数之间允许有空格。命名函数还需要function
关键字和函数名称之间的空格,但匿名函数不需要空格。例如:
function withoutSpace(x) {
// ...
}
function withSpace (x) {
// ...
}
var anonymousWithoutSpace = function() {};
var anonymousWithSpace = function () {};
样式指南在function
匿名函数的关键字之后可能需要一个空格,而另一些则不指定空白。同样,函数名称后面的空格可能需要也可能不需要。
规则细节
此规则旨在在函数括号之前强制执行一致的间距,因此,只要空格不符合指定的偏好,就会发出警告。
这条规则有一个参数。如果是"always"
,这是默认选项,则所有命名函数和匿名函数在函数括号之前必须有空格。如果"never"
那么所有命名函数和匿名函数在函数括号之前都不能有空格。如果你想为命名和匿名函数使用不同的间距,你可以传递一个配置对象作为规则参数来分别配置它们(例如{"anonymous": "always", "named": "never"}
)。
此规则的默认代码错误
代码示例"always"
:
/*eslint-env es6*/
function foo() {
// ...
}
var bar = function() {
// ...
};
var bar = function foo() {
// ...
};
class Foo {
constructor() {
// ...
}
}
var foo = {
bar() {
// ...
}
};
具有默认选项的此规则的正确
代码示例"always"
:
/*eslint-env es6*/
function foo () {
// ...
}
var bar = function () {
// ...
};
var bar = function foo () {
// ...
};
class Foo {
constructor () {
// ...
}
}
var foo = {
bar () {
// ...
}
};
此规则的错误
代码示例包含以下"never"
选项:
/*eslint-env es6*/
function foo () {
// ...
}
var bar = function () {
// ...
};
var bar = function foo () {
// ...
};
class Foo {
constructor () {
// ...
}
}
var foo = {
bar () {
// ...
}
};
此规则的正确
代码示例包含以下"never"
选项:
/*eslint-env es6*/
function foo() {
// ...
}
var bar = function() {
// ...
};
var bar = function foo() {
// ...
};
class Foo {
constructor() {
// ...
}
}
var foo = {
bar() {
// ...
}
};
此规则的错误
代码示例包含以下{"anonymous": "always", "named": "never"}
选项:
/*eslint-env es6*/
function foo () {
// ...
}
var bar = function() {
// ...
};
class Foo {
constructor () {
// ...
}
}
var foo = {
bar () {
// ...
}
};
此规则的正确
代码示例包含以下{"anonymous": "always", "named": "never"}
选项:
/*eslint-env es6*/
function foo() {
// ...
}
var bar = function () {
// ...
};
class Foo {
constructor() {
// ...
}
}
var foo = {
bar() {
// ...
}
};
此规则的错误
代码示例包含以下{"anonymous": "never", "named": "always"}
选项:
/*eslint-env es6*/
function foo() {
// ...
}
var bar = function () {
// ...
};
class Foo {
constructor() {
// ...
}
}
var foo = {
bar() {
// ...
}
};
此规则的正确
代码示例包含以下{"anonymous": "never", "named": "always"}
选项:
/*eslint-env es6*/
function foo () {
// ...
}
var bar = function() {
// ...
};
class Foo {
constructor () {
// ...
}
}
var foo = {
bar () {
// ...
}
};
何时不使用
如果在函数括号之前不关心间距的一致性,则可以关闭此规则。
相关规则
- space-after-keywords
- space-return-throw-case
版本
此规则在ESLint 0.15.0中引入,并在1.0.0-rc-1中删除。