Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The optional displayName
property of a Function
instance specifies the display name of the function.
Value
The displayName
property is not initially present on any function — it's added by the code authors. For the purpose of display, it should be a string.
Description
The displayName
property, if present, may be preferred by consoles and profilers over the name
property to be displayed as the name of a function.
Among browsers, only the Firefox console utilizes this property. React devtools also use the displayName
property when displaying the component tree.
Firefox does some basic attempts to decode the displayName
that's possibly generated by the anonymous JavaScript functions naming convention algorithm. The following patterns are detected:
- If
displayName
ends with a sequence of alphanumeric characters, _
, and $
, the longest such suffix is displayed.
- If
displayName
ends with a sequence of []
-enclosed characters, that sequence is displayed without the square brackets.
- If
displayName
ends with a sequence of alphanumeric characters and _
followed by some /
, .
, or <
, the sequence is returned without the trailing /
, .
, or <
characters.
- If
displayName
ends with a sequence of alphanumeric characters and _
followed by (^)
, the sequence is displayed without the (^)
.
If none of the above patterns match, the entire displayName
is displayed.
Setting a displayName
By entering the following in a Firefox console, it should display as something like function MyFunction()
:
const a = function () {};
a.displayName = "MyFunction";
a;
Changing displayName dynamically
You can dynamically change the displayName
of a function:
const object = {
someMethod: function someMethod(value) {
someMethod.displayName = `someMethod (${value})`;
},
};
console.log(object.someMethod.displayName);
object.someMethod("123");
console.log(object.someMethod.displayName);
Cleaning of displayName
Firefox devtools would clean up a few common patterns in the displayName
property before displaying it.
function foo() {}
function testName(name) {
foo.displayName = name;
console.log(foo);
}
testName("$foo$");
testName("foo bar");
testName("Foo.prototype.add");
testName("foo .");
testName("foo <");
testName("foo?");
testName("foo()");
testName("[...]");
testName("foo<");
testName("foo...");
testName("foo(^)");
Specifications
Not part of any standard.
Browser compatibility
|
Desktop |
Mobile |
Server |
|
Chrome |
Edge |
Firefox |
Opera |
Safari |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
WebView Android |
Deno |
Node.js |
displayName |
No |
No |
13 |
No |
No |
No |
14 |
No |
No |
No |
No |
No |
No |