Function.name

Интерактивный пример

const func1 = function () {}; const object = { func2: function () {}, }; console.log(func1.name); // Expected output: "func1" console.log(object.func2.name); // Expected output: "func2" 

Значение

Строка.

Примеры

Имя объявленной функции

Свойство name возвращает имя функции, либо пустую строку для анонимных функций:

function doSomething() {} alert(doSomething.name); // выведет "doSomething" 

Имя функции-конструктора

Функции, созданные синтаксисом new Function(...) или просто Function(...) создают Function и имеют name "anonymous":

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

Предполагаемые имена функций

Переменные и методы могут предположить название анонимной функции из её синтаксической позиции (new in ECMAScript 2015).

var f = function () {}; var object = { someMethod: function () {}, }; console.log(f.name); // "f" console.log(object.someMethod.name); // "someMethod" 

Вы можете определить функцию с именем в function expression:

var object = { someMethod: function object_someMethod() {}, }; console.log(object.someMethod.name); // выведет "object_someMethod" try { object_someMethod; } catch (e) { console.log(e); } // ReferenceError: object_someMethod is not defined 

Вы не можете изменить имя функции, это свойство только для чтения:

var object = { // анонимная функция someMethod: function () {}, }; object.someMethod.name = "otherMethod"; alert(object.someMethod.name); //someMethod 

Для изменения name можно использовать Object.defineProperty().

Сокращённые имена методов

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

Имена функций после привязки

Function.bind() производит функцию, получающую имя "bound и название самой функции.

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

Имена функций для getters и setters

Когда используются get и set, "get" и "set" появятся в имени функции.

let 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 чтобы проверить "class" объекта (читайте предупреждение ниже):

function Foo() {} // ES2015 Syntax: class Foo {} var fooInstance = new Foo(); console.log(fooInstance.constructor.name); // logs "Foo" 

Таким образом, нельзя получить доступ к name любого класса со статичным свойством 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 с помощью fooInstance.constructor.name не даст название класса, но выведет метод name(). Пример:

let fooInstance = new Foo(); console.log(fooInstance.constructor.name); // logs function name() 

Из ES5 syntax примера также видно, что в Chrome или Firefox статичное определение Foo.name становится записываемым (writable). Встроенное определение в отсутствии кастомного статичного методадоступно только для чтения:

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

Следовательно не ожидайте, что Function.name свойство будет всегда содержать имя класса.

Имена функций-символов

Если у Symbol объявляется имя, то название метода - это имя квадратных скобках.

let sym1 = Symbol("foo"); let sym2 = Symbol(); let o = { [sym1]: function () {}, [sym2]: function () {}, }; o[sym1].name; // "[foo]" o[sym2].name; // "" 

JavaScript минифицированный

Такой source code:

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

может быть сжат в:

function a() {}; let 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'". В то время, как в сжатой версии он ведёт себя иначе. Если вы полагаетесь на Function.name, как в примере, то убедитесь, что pipeline не меняет код или не ожидайте от функции определённого имени.

Спецификации

Совместимость с браузерами