Function.name

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

A propriedade somente-leitura name de um objeto Function indica o nome da função como especificado quando esta foi criada, ou "anonymous" para funções criadas anonimamente.

Experimente

Property attributes of Function.name
Writable no
Enumerable no
Configurable yes

Nota: Note que em implementações não-standard anteriores à ES2015 o atributo configurable tinha também o valor false.

Exemplos

Nome de declaração da função

A propriedade name retorna o nome de uma declaração de função.

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

Nome do construtor da função

Funções criadas com a sintaxe new Function(...) ou somente Function(...) criam objetos Function com o nome "anonymous".

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

Nomes de função inferidos

Variáveis e métodos podem inferir o nome de uma função anônima a partir de sua posição sintática (novo na ECMAScript 2015).

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

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

Você pode definir uma função com um nome numa expressão de função:

js
var object = {
  someMethod: function object_someMethod() {},
};
console.log(object.someMethod.name); // grava o log "object_someMethod"

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

Você não pode mudar o nome de uma função, pois a propriedade é somente-leitura:

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

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

Para mudá-lo, você poderia no entanto usar Object.defineProperty().

Nomes curtos de métodos

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

Nomes de funções vinculadas

Function.bind() produz uma função cujo nome é "bound " seguido do nome da função.

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

Nomes de função para getters e setters

Ao usar propriedades acessórias get e set, "get" ou "set" aparecerão no nome da função.

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

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

Nomes de funções em classes

Você pode usar obj.constructor.name para checar a "classe" de um objeto (porém leia com atenção os avisos abaixo):

js
function Foo() {} // Sintaxe ES2015: class Foo {}

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

Aviso: O interpretador vai definir a propriedade interna Function.name somente se uma função não tiver uma propriedade já com o nome name (veja a seção 9.2.11 da ECMAScript2015 Language Specification). Porém, a ES2015 especifica que a palavra-chave static de maneira que métodos estáticos serão definidos como OwnProperty da função construtora de classe (ECMAScript2015, 14.5.14.21.b + 12.2.6.9).

Portanto não podemos obter o nome de virtualmente qualquer classe com um método estático name():

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

Com um método static name(), Foo.name não guarda mais o nome verdadeiro da classe mas uma referência ao objeto de função name(). A definição de classe acima, escrita em sintaxe ES2015, se comportará de maneira similar ao seguinte trecho de código em sintaxe ES5 no Chrome ou no Firefox:

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

Tentar obter a classe de fooInstance via fooInstance.constructor.name não nos dará de maneira alguma o nome da classe, mas sim uma referência ao método estático da classe. Exemplo:

js
var fooInstance = new Foo();
console.log(fooInstance.constructor.name); // grava o name() da função no log

Você pode ver também, a partir do exemplo de sintaxe ES5, que, no Chrome ou no Firefox, a nossa definição estática de Foo.name se torna writable. A predefinição interna na ausência de uma definição estática customizada é somente-leitura:

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

Portanto, você não pode assumir que a propriedade interna Function.name sempre guardará um nome de classe..

Símbolos como nome de função

Se um Symbol é usado como nome de função e o símbolo tem uma descrição, o nome do método será a descrição entre colchetes.

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

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

Compressores e minificadores JavaScript

Aviso: Tenha cuidado ao usar Function.name e transformações de código-fonte, como aquelas executadas por compressores (minificadores) ou obfuscadores de JavaScript. Estas ferramentas são comumente usadas como parte de processos de build de JavaScript para reduzir os tamanhos de programas antes da implementação em produção. Tais transformações frequentemente mudam nomes de função durante o build.

Código fonte do tipo:

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

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

pode ser comprimido e se tornar:

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

Na versão descomprimida, o programa cai no bloco-verdade e grava o log 'foo' is an instance of 'Foo'. Todavia, na versão comprimida ele se comporta diferentemente, e cai no bloco else. Se você depende de Function.name, como no exemplo acima, tenha certeza que seu processo de build não mude nomes de função, ou então não assuma que uma função terá um nome determinado.

Especificações

Specification
ECMAScript Language Specification
# sec-function-instances-name

Compatibilidade com navegadores

BCD tables only load in the browser