# func-style

强制一致地使用 function 声明或表达式

在 JavaScript 中有两种定义函数的方式：function 声明和 function 表达式。声明首先包含 function 关键字，然后是名称，然后是其参数和函数体，例如：

function doSomething() {
    // ...
}

等效函数表达式以 var 关键字开头，后跟名称，然后是函数本身，例如：

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

function 声明和 function expressions 之间的主要区别在于声明被提升到定义它们的范围的顶部，这允许您编写在声明之前使用函数的代码。例如：

doSomething();

function doSomething() {
    // ...
}

尽管这段代码看起来像是一个错误，但实际上它运行良好，因为 JavaScript 引擎将 function 声明提升到了作用域的顶部。这意味着此代码被视为声明出现在调用之前。

对于function表达式，必须在使用前定义函数，否则会报错。例子：

doSomething();  // error!

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

在这种情况下，调用时 doSomething() 未定义，因此会导致运行时错误。

由于这些不同的行为，通常有关于应该使用哪种函数样式的指南。这里真的没有正确或错误的选择，这只是一种偏好。

# 规则详情

此规则在整个 JavaScript 文件中强制使用特定类型的 function 样式，无论是声明还是表达式。您可以在配置中指定您喜欢的。

# 选项

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

"expression"（默认）需要使用函数表达式而不是函数声明
"declaration" 要求使用函数声明而不是函数表达式

此规则有一个异常的对象选项：

"allowArrowFunctions"：true（默认false）允许使用箭头功能。此选项仅在字符串选项设置为 "declaration" 时适用（无论此选项如何，当字符串选项设置为 "expression" 时始终允许使用箭头功能）

# expression

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

/*eslint func-style: ["error", "expression"]*/

function foo() {
    // ...
}

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

/*eslint func-style: ["error", "expression"]*/

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

var foo = () => {};

// allowed as allowArrowFunctions : false is applied only for declaration

# declaration

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

/*eslint func-style: ["error", "declaration"]*/

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

var foo = () => {};

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

/*eslint func-style: ["error", "declaration"]*/

function foo() {
    // ...
}

// Methods (functions assigned to objects) are not checked by this rule
SomeObject.foo = function() {
    // ...
};

# allowArrowFunctions

此规则使用 "declaration", { "allowArrowFunctions": true } 选项的其他正确代码示例：

/*eslint func-style: ["error", "declaration", { "allowArrowFunctions": true }]*/

var foo = () => {};

# 何时不使用

如果您想让开发人员各自决定他们想要如何编写函数，那么您可以禁用此规则。

← func-names grouped-accessor-pairs →