func-names

要求或禁止命名function表达式（ func-names ）

越来越常见的模式是给函数表达式名称以帮助调试。例如：

Foo.prototype.bar = function bar() {};

bar在上面的例子中添加第二个是可选的。如果离开函数名称，那么当函数抛出异常时，您可能会anonymous function在堆栈跟踪中看到类似的东西。如果您为函数表达式提供了可选名称，那么您将在堆栈跟踪中获得函数表达式的名称。

规则细节

该规则可以强制或禁止使用命名函数表达式。

选项

这条规则有一个字符串选项：

• "always" （默认）要求函数表达式具有名称

• "as-needed" 如果名称不能在 ES6 环境中自动分配，则要求函数表达式具有名称

• "never" 不允许使用命名函数表达式，除了需要名称的递归函数

always

此规则的默认代码错误代码示例"always"：

/*eslint func-names: ["error", "always"]*/

Foo.prototype.bar = function() {};

(function() {
    // ...
}())

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

/*eslint func-names: ["error", "always"]*/

Foo.prototype.bar = function bar() {};

(function bar() {
    // ...
}())

as-needed

ECMAScript 6引入了name所有功能的属性。name通过评估函数周围的代码来确定名称是否可以推断，从而确定其值。例如，分配给变量的函数将自动具有name与变量名称相同的属性。name然后将该值用于堆栈跟踪以便于调试。

此规则的默认代码错误代码示例"as-needed"：

/*eslint func-names: ["error", "as-needed"]*/

Foo.prototype.bar = function() {};

(function() {
    // ...
}())

具有默认选项的此规则的正确代码示例"as-needed"：

/*eslint func-names: ["error", "as-needed"]*/

var bar = function() {};

(function bar() {
    // ...
}())

never

此规则的错误代码示例包含以下"never"选项：

/*eslint func-names: ["error", "never"]*/

Foo.prototype.bar = function bar() {};

(function bar() {
    // ...
}())

此规则的正确代码示例包含以下"never"选项：

/*eslint func-names: ["error", "never"]*/

Foo.prototype.bar = function() {};

(function() {
    // ...
}())

进一步阅读

• Functions Explained

• Function Names in ES6

兼容性

• JSCS: requireAnonymousFunctions

• JSCS: disallowAnonymousFunctions

版本

这条规则是在 ESLint 0.4.0 中引入的。

资源

• Rule source

• Documentation source