From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/function/name/index.html | 219 +++++++++++++++++++++ 1 file changed, 219 insertions(+) create mode 100644 files/zh-cn/web/javascript/reference/global_objects/function/name/index.html (limited to 'files/zh-cn/web/javascript/reference/global_objects/function/name') diff --git a/files/zh-cn/web/javascript/reference/global_objects/function/name/index.html b/files/zh-cn/web/javascript/reference/global_objects/function/name/index.html new file mode 100644 index 0000000000..3c701acdca --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/function/name/index.html @@ -0,0 +1,219 @@ +--- +title: Function.name +slug: Web/JavaScript/Reference/Global_Objects/Function/name +tags: + - ECMAScript 2015 + - Function + - JavaScript + - Property +translation_of: Web/JavaScript/Reference/Global_Objects/Function/name +--- +
{{JSRef("Global_Objects", "Function")}}
+ +
function.name 属性返回函数实例的名称。
+ +

{{js_property_attributes(0,0,1)}}

+ +
+

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

+
+ +

示例

+ +

函数声明的名称

+ +

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

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

构造函数的名称

+ +

使用new Function(...)语法创建的函数或只是 Function(...) create {{jsxref("Function")}}对象及其名称为“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"
+ +

你可以在 {{jsxref("Operators/Function", "函数表达式", "", 1)}}中定义函数的名称:

+ +
var object = {
+  someMethod: function object_someMethod() {}
+};
+
+console.log(object.someMethod.name); // "object_someMethod"
+
+try { object_someMethod } catch(e) { alert(e); }
+// ReferenceError: object_someMethod is not defined
+
+ +

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

+ + + +
var object = {
+  // anonymous
+  someMethod: function() {}
+};
+
+object.someMethod.name = 'otherMethod';
+console.log(object.someMethod.name); // someMethod
+ +

要更改它，可以使用{{jsxref("Object.defineProperty()")}}。

+ +

简写方法的名称

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

绑定函数的名称

+ +

{{jsxref("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);
+//如果Foo具有静态name()属性，则输出“Hello”，否则为“Foo”
+
+ +

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

+ +

Symbol作为函数名称

+ +

如果{{jsxref("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，就像上面的示例一样，确保您的构建管道不会更改函数名称，也不要假定函数具有特定的名称。

+ +
+

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-name', 'name')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-name', 'name')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容性

+ + + +

{{Compat("javascript.builtins.Function.name")}}

+
-- cgit v1.2.3-54-g00ecf