# space-before-function-paren

在 function 定义左括号之前强制保持一致的间距

一些该规则报告的问题可以通过 --fix 命令行选项自动修复

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

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

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

var anonymousWithoutSpace = function() {};

var anonymousWithSpace = function () {};

样式指南可能要求匿名函数的 function 关键字后有一个空格，而另一些则不指定空格。同样，函数名后面的空格可能需要也可能不需要。

# 规则详情

此规则旨在在函数括号之前强制执行一致的间距，因此，只要空格与指定的首选项不匹配，就会发出警告。

# 选项

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

{
    "space-before-function-paren": ["error", "always"],
    // or
    "space-before-function-paren": ["error", {
        "anonymous": "always",
        "named": "always",
        "asyncArrow": "always"
    }],
}

always（默认）需要一个空格，后跟 ( 参数。
never 不允许任何空格后跟 ( 参数。

string 选项不检查异步箭头函数表达式的向后兼容性。

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

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

# "always"

此规则使用默认 "always" 选项的错误代码示例：

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

function foo() {
    // ...
}

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

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

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

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

var foo = async() => 1

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

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

function foo () {
    // ...
}

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

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

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

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

var foo = async () => 1

# "never"

此规则使用 "never" 选项的错误代码示例：

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

function foo () {
    // ...
}

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

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

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

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

var foo = async () => 1

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

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

function foo() {
    // ...
}

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

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

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

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

var foo = async() => 1

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

此规则使用 {"anonymous": "always", "named": "never", "asyncArrow": "always"} 选项的错误代码示例：

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

function foo () {
    // ...
}

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

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

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

var foo = async(a) => await a

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

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

function foo() {
    // ...
}

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

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

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

var foo = async (a) => await a

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

此规则使用 {"anonymous": "never", "named": "always"} 选项的错误代码示例：

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

function foo() {
    // ...
}

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

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

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

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

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

function foo () {
    // ...
}

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

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

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

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

此规则使用 {"anonymous": "ignore", "named": "always"} 选项的错误代码示例：

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

function foo() {
    // ...
}

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

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

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

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

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

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

function foo () {
    // ...
}

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

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

# 何时不使用

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

← space-before-blocks space-in-parens →