ESLint 风格

外观

@stylistic/

space-before-function-paren ​

格式化函数时，函数名称或 function 关键字与左括号之间允许有空格。命名函数还需要在 function 关键字与函数名称之间留一个空格，但匿名函数不需要空格。例如

js
function withoutSpace(x) {
    // ...
}

function withSpace (x) {
    // ...
}

var anonymousWithoutSpace = function() {};

var anonymousWithSpace = function () {};

样式指南可能要求匿名函数的 function 关键字后留一个空格，而其他指南则指定不留空格。类似地，函数名称后的空格可能需要也可能不需要。

规则详情 ​

此规则旨在强制在函数括号前使用一致的空格，因此，只要空格不符合指定的首选项，就会发出警告。

选项 ​

此规则有一个字符串选项或一个对象选项

js
{
    "space-before-function-paren": ["error", "always"],
    // or
    "space-before-function-paren": ["error", {
        "anonymous": "always",
        "named": "always",
        "asyncArrow": "always"
    }],
}
  • always（默认）要求在参数的 ( 前留一个空格。
  • never 不允许在参数的 ( 前留任何空格。

为了向后兼容，字符串选项不会检查异步箭头函数表达式。

您还可以为每种类型的函数使用单独的选项。以下每个选项都可以设置为 "always"、"never" 或 "ignore"。默认值为 "always"。

  • anonymous 用于匿名函数表达式（例如 function () {}）。
  • named 用于命名函数表达式（例如 function foo () {}）。
  • asyncArrow 适用于异步箭头函数表达式（例如 async () => {}）。

"always" ​

使用默认 "always" 选项时，此规则的不正确代码示例

js
/*eslint @stylistic/space-before-function-paren: "error"*/
/*eslint-env es6*/

function foo
(
) {
    // ...
}

var bar = function
(
) {
    // ...
};

var bar = function foo
(
) {
    // ...
};

class Foo {
    constructor
(
) {
        // ...
    }
}

var baz = {
    bar
(
) {
        // ...
    }
};

var baz = async
(
) => 1
不正确

使用默认 "always" 选项时，此规则的正确代码示例

js
/*eslint @stylistic/space-before-function-paren: "error"*/
/*eslint-env es6*/

function foo () {
    // ...
}

var bar = function () {
    // ...
};

var bar = function foo () {
    // ...
};

class Foo {
    constructor () {
        // ...
    }
}

var baz = {
    bar () {
        // ...
    }
};

var baz = async () => 1
正确

"never" ​

使用 "never" 选项时，此规则的不正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", "never"]*/
/*eslint-env es6*/

function foo
 
() {
    // ...
}

var bar = function
 
() {
    // ...
};

var bar = function foo
 
() {
    // ...
};

class Foo {
    constructor
 
() {
        // ...
    }
}

var baz = {
    bar
 
() {
        // ...
    }
};

var baz = async
 
() => 1
不正确

使用 "never" 选项时，此规则的正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", "never"]*/
/*eslint-env es6*/

function foo() {
    // ...
}

var bar = function() {
    // ...
};

var bar = function foo() {
    // ...
};

class Foo {
    constructor() {
        // ...
    }
}

var baz = {
    bar() {
        // ...
    }
};

var baz = async() => 1
正确

{"anonymous": "always", "named": "never", "asyncArrow": "always"} ​

使用 {"anonymous": "always", "named": "never", "asyncArrow": "always"} 选项时，此规则的不正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", {"anonymous": "always", "named": "never", "asyncArrow": "always"}]*/
/*eslint-env es6*/

function foo
 
() {
    // ...
}

var bar = function
(
) {
    // ...
};

class Foo {
    constructor
 
() {
        // ...
    }
}

var baz = {
    bar
 
() {
        // ...
    }
};

var baz = async
(
a) => await a
不正确

使用 {"anonymous": "always", "named": "never", "asyncArrow": "always"} 选项时，此规则的正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", {"anonymous": "always", "named": "never", "asyncArrow": "always"}]*/
/*eslint-env es6*/

function foo() {
    // ...
}

var bar = function () {
    // ...
};

class Foo {
    constructor() {
        // ...
    }
}

var baz = {
    bar() {
        // ...
    }
};

var baz = async (a) => await a
正确

{"anonymous": "never", "named": "always"} ​

使用 {"anonymous": "never", "named": "always"} 选项时，此规则的不正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", { "anonymous": "never", "named": "always" }]*/
/*eslint-env es6*/

function foo
(
) {
    // ...
}

var bar = function
 
() {
    // ...
};

class Foo {
    constructor
(
) {
        // ...
    }
}

var baz = {
    bar
(
) {
        // ...
    }
};
不正确

使用 {"anonymous": "never", "named": "always"} 选项时，此规则的正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", { "anonymous": "never", "named": "always" }]*/
/*eslint-env es6*/

function foo () {
    // ...
}

var bar = function() {
    // ...
};

class Foo {
    constructor () {
        // ...
    }
}

var baz = {
    bar () {
        // ...
    }
};
正确

{"anonymous": "ignore", "named": "always"} ​

使用 {"anonymous": "ignore", "named": "always"} 选项时，此规则的不正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", { "anonymous": "ignore", "named": "always" }]*/
/*eslint-env es6*/

function foo
(
) {
    // ...
}

class Foo {
    constructor
(
) {
        // ...
    }
}

var baz = {
    bar
(
) {
        // ...
    }
};
不正确

使用 {"anonymous": "ignore", "named": "always"} 选项时，此规则的正确代码示例

js
/*eslint @stylistic/space-before-function-paren: ["error", { "anonymous": "ignore", "named": "always" }]*/
/*eslint-env es6*/

var bar = function() {
    // ...
};

var bar = function () {
    // ...
};

function foo () {
    // ...
}

class Foo {
    constructor () {
        // ...
    }
}

var baz = {
    bar () {
        // ...
    }
};
正确

何时不使用 ​

如果你不关心函数括号前间距的一致性，可以关闭此规则。

TypeScript 特有 ​

ts/space-before-function-paren ​