Функция

Объект Function предоставляет методы для функций. В JavaScript каждая функция фактически является объектом Function.

Конструктор

Function()

Создает новый объект Function. Прямой вызов конструктора может динамически создавать функции, но страдает от проблем с безопасностью и схожих (но гораздо менее значительных) проблем с производительностью, как у eval(). Однако, в отличие от eval(), конструктор Function создает функции, которые выполняются только в глобальной области видимости.

Свойства экземпляра

Эти свойства определены для Function.prototype и разделяются всеми экземплярами Function.

Function.prototype.arguments Устарело Нестандартно

Представляет аргументы, переданные этой функции. Для строгого режима, стрелочных, асинхронных и генераторных функций доступ к свойству arguments вызывает TypeError. Вместо этого используйте объект arguments внутри замыканий функций.

Function.prototype.caller Устарело Нестандартно

Представляет функцию, которая вызвала эту функцию. Для строгого режима, стрелочных, асинхронных и генераторных функций доступ к свойству caller вызывает TypeError.

Function.prototype.constructor

Конструктор, который создал объект экземпляра. Для экземпляров Function начальным значением является конструктор Function.

Эти свойства являются собственными свойствами каждого экземпляра Function.

displayName Нестандартно Необязательно

Отображаемое имя функции.

length

Указывает количество аргументов, ожидаемых функцией.

name

Имя функции.

prototype

Используется, когда функция используется как конструктор с оператором new. Он станет прототипом нового объекта.

Методы экземпляра

Function.prototype.apply()

Вызывает функцию с заданным значением this и необязательными аргументами, предоставленными в виде массива (или массивоподобного объекта).

Function.prototype.bind()

Создает новую функцию, которая при вызове имеет свое ключевое слово this, установленное в предоставленное значение, опционально с заданной последовательностью аргументов, предшествующих любым предоставленным при вызове новой функции.

Function.prototype.call()

Вызывает функцию с заданным значением this и необязательными аргументами.

Function.prototype.toString()

Возвращает строку, представляющую исходный код функции. Переопределяет метод Object.prototype.toString.

Function.prototype[Symbol.hasInstance]()

Определяет процедуру по умолчанию для определения того, распознает ли функция-конструктор объект как один из экземпляров конструктора. Вызывается оператором instanceof.

Примеры

Разница между конструктором Function и объявлением функции

Функции, созданные с помощью конструктора Function, не создают замыканий к своим контекстам создания; они всегда создаются в глобальной области видимости. При их выполнении они смогут получить доступ только к своим собственным локальным переменным и глобальным, но не к переменным из области видимости, в которой был создан конструктор Function. Это отличается от использования eval() с кодом для выражения функции.

// Create a global property with `var`
var x = 10;

function createFunction1() {
  const x = 20;
  return new Function("return x;"); // this `x` refers to global `x`
}

function createFunction2() {
  const x = 20;
  function f() {
    return x; // this `x` refers to the local `x` above
  }
  return f;
}

const f1 = createFunction1();
console.log(f1()); // 10
const f2 = createFunction2();
console.log(f2()); // 20

Хотя этот код работает в веб-браузерах, f1() вызовет ReferenceError в Node.js, так как x не будет найден. Это связано с тем, что верхний уровень области видимости в Node не является глобальной областью видимости, и x будет локальным для модуля.

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

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

См. также

• function
• function expression
• AsyncFunction
• AsyncGeneratorFunction
• GeneratorFunction
• Функции