Function.displayName

Não padrão: Este recurso não é padronizado. Não recomendamos o uso de recursos não padronizados em produção, pois eles têm suporte limitado nos navegadores e podem mudar ou ser removidos. No entanto, podem ser uma alternativa viável em casos específicos onde não exista uma opção padrão.

A propriedade function.displayName retorna o nome de exibição da função.

Descrição

Quando definida, a propriedade displayName retorna o nome de exibição da função.

function doSomething() {}

console.log(doSomething.displayName); // "undefined"

var popup = function (content) {
  console.log(content);
};

popup.displayName = "Show Popup";

console.log(popup.displayName); // "Show Popup"

Você pode definir uma função com uma nome de exibição em um function expression:

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

object.someMethod.displayName = "someMethod";

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

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

Você pode mudar dinamicamente odisplayName de uma função:

var object = {
  // anonymous
  someMethod: function (value) {
    arguments.callee.displayName = "someMethod (" + value + ")";
  },
};

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

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

Exemplos

Geralmente, é preferida por consoles e perfis em vez de func.name mostrar o nome de uma função.

Entrando com o seguinte em um console, isso deverá mostrar algo como "function My Function()":

var a = function () {};
a.displayName = "My Function";

a; // "function My Function()"

Especificações

Não faz parte de denhuma especificação.

Compatibilidade com navegadores