大网数据广告活动
Web 标准与前端开发

Function.displayName

· 52CE 我爱测

Function 实例的 **`displayName`** 可选属性指定函数的显示名称。

Function 实例的 displayName 可选属性指定函数的显示名称。

值

displayName 属性最初在任何函数上都不存在,它是由代码作者添加的。出于显示的目的,它应该是一个字符串。

描述

如果存在 displayName 属性,其可能会被控制台和性能分析工具优先选择,作为函数的名称显示。

在各种浏览器中,只有 Firefox 控制台使用该属性。React 开发者工具在显示组件树时也使用 displayName 属性。

Firefox 对可能由匿名 JavaScript 函数命名约定算法生成的 displayName 进行了一些基本的解码尝试。以下模式可以被检测到:

  • 如果 displayName 以一系列字母数字字符、_ 和 $ 结尾,最长的这种后缀将被显示。
  • 如果 displayName 以一系列以 [] 包围的字符结尾,该序列将被显示,但不包括方括号。
  • 如果 displayName 以一系列字母数字字符和 _,后面跟着一些 /、. 或 < 结尾,将返回该序列,但不包括尾部的 /、. 或 < 字符。
  • 如果 displayName 以一系列字母数字字符和 _,后面跟着 (^) 结尾,该序列将被显示,但不包括 (^)。

如果以上模式都不匹配,则显示整个 displayName。

示例

设置 displayName

通过在 Firefox 控制台中输入以下内容,它应该显示为类似 function MyFunction() 的内容:

const a = function () {};
a.displayName = "MyFunction";

a; // function MyFunction()

动态更改 displayName

你可以动态更改函数的 displayName:

const object = {
  // anonymous
  someMethod: function someMethod(value) {
    someMethod.displayName = `someMethod (${value})`;
  },
};

console.log(object.someMethod.displayName); // undefined

object.someMethod("123");
console.log(object.someMethod.displayName); // "someMethod (123)"

清理 displayName

Firefox 开发者工具会在显示 displayName 属性之前清理一些常见的模式。

function foo() {}

function testName(name) {
  foo.displayName = name;
  console.log(foo);
}

testName("$foo$"); // function $foo$()
testName("foo bar"); // function bar()
testName("Foo.prototype.add"); // function add()
testName("foo ."); // function foo .()
testName("foo <"); // function foo <()
testName("foo?"); // function foo?()
testName("foo()"); // function foo()()

testName("[...]"); // function ...()
testName("foo<"); // function foo()
testName("foo..."); // function foo()
testName("foo(^)"); // function foo()

规范

不属于任何规范。

浏览器兼容性

参见

  • Function.prototype.name

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。