Function

Об'єкт 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() з кодом для виразу функції.

// Створити глобальну властивість за допомогою `var`
var x = 10;

function createFunction1() {
  const x = 20;
  return new Function("return x;"); // цей `x` посилається на глобальний `x`
}

function createFunction2() {
  const x = 20;
  function f() {
    return x; // цей `x` посилається на локальний `x` вище
  }
  return f;
}

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

Попри те, що цей код працює у веббраузерах, f1() у Node.js видасть ReferenceError, оскільки x не буде знайдено. Це пов'язано з тим, що найвища область видимості в Node не є глобальною, і x буде локальною щодо свого модуля.

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

Сумісність із браузерами

Дивіться також

• function
• Вираз function
• AsyncFunction
• AsyncGeneratorFunction
• GeneratorFunction
• Функції