function.name

function.name?属性返回函数实例的名称。

| Function.name属性的属性特性 |

|:----|

| Writable | no |

| Enumerable | no |

| Configurable | yes |

请注意，在非标准的ES2015之前的实现中，configurable属性也是false?。

示例

函数声明的名称

name?属性返回一个函数声明的名称。

function doSomething() {}
doSomething.name; // "doSomething"

构造函数的名称

使用new Function(...)语法创建的函数或只是?Function(...) createFunction对象及其名称为“anonymous”。

(new Function).name; // "anonymous"

推断函数名称

变量和方法可以从句法位置推断匿名函数的名称（ECMAScript 2015中新增）。

var f = function() {};
var object = {
  someMethod: function() {}
};

console.log(f.name); // "f"
console.log(object.someMethod.name); // "someMethod"

你可以在函数表达式中定义函数的名称:

var object = {
  someMethod: function object_someMethod() {}
};
console.log(object.someMethod.name); // logs "object_someMethod"

try { object_someMethod } catch(e) { console.log(e); }
// ReferenceError: object_someMethod is not defined

你不能更改函数的名称，此属性是只读的：

var object = {
  // anonymous
  someMethod: function() {}
};

object.someMethod.name = 'otherMethod';
console.log(object.someMethod.name); // someMethod

要更改它，可以使用Object.defineProperty()。

简写方法的名称

var o = {
  foo(){}
};
o.foo.name; // "foo";

绑定函数的名称

Function.bind()所创建的函数将会在函数的名称前加上"bound " 。

function foo() {}; 
foo.bind({}).name; // "bound foo"

getters 和 setters 的函数名

当通过?get?和?set?访问器来存取属性时, "get" 或 "set" 会出现在函数名称前。

var o = { 
  get foo(){}, 
  set foo(x){} 
}; 

var descriptor = Object.getOwnPropertyDescriptor(o, "foo"); 
descriptor.get.name; // "get foo" 
descriptor.set.name; // "set foo";

类中的函数名称

你可以使用obj.constructor.name来检查对象的“类”（但请务必阅读以下警告）：

function Foo() {}  // ES2015 Syntax: class Foo {}

var fooInstance = new Foo();
console.log(fooInstance.constructor.name); // logs "Foo"

警告：脚本解释器只有在函数没有名为name的属性时才会设置内置的Function.name属性（参见?9.2.11 of the ECMAScript2015 Language Specification）。但是，ES2015规定由关键字static修饰的静态方法也会被认为是类的属性（ECMAScript2015,?14.5.14.21.b?+?12.2.6.9）。

因此，我们无法获取具有静态方法属性name()的几乎任何类的类名称：

class Foo {
  constructor() {}
  static name() {}
}

使用static name()方法Foo.name不再保存实际的类名称，而是引用name()函数对象。 ES2015语法中的上述类定义将在Chrome或Firefox中运行，类似于ES5语法中的以下代码段：

function Foo() {}
Object.defineProperty(Foo, 'name', { writable: true });
Foo.name = function() {};

通过fooInstance.constructor.name获取fooInstance类不会给我们所有的类名，而是静态类方法的引用。例如：

var fooInstance = new Foo();
console.log(fooInstance.constructor.name); // logs function name()

你也可以从ES5语法示例中看到，在Chrome或Firefox的中静态定义的Foo.name变得可写。内置定义在没有自定义静态定义时是只读的：

Foo.name = 'Hello';
console.log(Foo.name); // logs "Hello" if class Foo has a static name() property but "Foo" if not.

因此，你不能依赖内置的Function.name属性来保持一个类的名称。

Symbol作为函数名称

如果Symbol被用于函数名称，并且这个symbol具有相应的描述符，那么方法的名字就是方括号中的描述符。

var sym1 = Symbol("foo"); 
var sym2 = Symbol(); 
var o = { 
  [sym1]: function(){}, 
  [sym2]: function(){} 
}; 

o[sym1].name; // "[foo]"
o[sym2].name; // ""

JavaScript 压缩和 minifiers

警告：当使用Function.name和那些JavaScript压缩器（minifiers）或混淆器进行源码转换时要小心。这些工具通常用作JavaScript构建管道的一部分，以在程序部署到生产之前减少程序的大小。但这种转换通常会在构建时更改函数的名称。

例如下面的代码:

function Foo() {};
var foo = new Foo();

if (foo.constructor.name === 'Foo') {
  console.log("'foo' is an instance of 'Foo'");
} else {
  console.log('Oops!');
}

可能被压缩为:

function a() {};
var b = new a();
if (b.constructor.name === 'Foo') {
  console.log("'foo' is an instance of 'Foo'");
} else {
  console.log('Oops!');
}

在未压缩版本中，程序运行到真实分支并打印'foo' is an instance of 'Foo'。而在压缩版本中，它的行为不同，并且进入else分支。如果您依赖于Function.name，就像上面的示例一样，确保您的构建管道不会更改函数名称，也不要假定函数具有特定的名称。

规范

Specification	Status	Comment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'name' in that specification.	Standard	Initial definition.
ECMAScript Latest Draft (ECMA-262)The definition of 'name' in that specification.	Living Standard	?

浏览器兼容性

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	15.0	(Yes)	(Yes)	12	(Yes)	(Yes)
Configurable: true	43.0	?	38 (38)	?	?	?
Inferred names on anonymous functions	51.0	?	53 (53)	?	?	?

Feature	Android	Android Webview	Edge	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile	Chrome for Android
Basic support	(Yes)	(Yes)	(Yes)	(Yes)	12	(Yes)	(Yes)	(Yes)
Configurable: true	?	?	?	38.0 (38)	?	?	?	?
Inferred names on anonymous functions	No support	51.0	?	53.0 (53)	?	?	?	51.0

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2017-12-18