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中删除。

资源

• Documentation source