mozilla
Your Search Results

    Function

    Сводка

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

    Синтаксис

    new Function([arg1[, arg2[, ...argN]],] functionBody)

    Параметры

    arg1, arg2, ... argN
    Имена, используемые функцией в качестве имён формальных аргументов. Каждое имя должно быть строкой, представляющий допустимый идентификатор JavaScript, либо списком таких строк, разделённых запятой; например "x", "theValue" или "a,b".
    functionBody
    Строка, содержащая инструкции JavaScript, составляющие определение функции.

    Описание

    Объекты Function, созданные констуктором Function, разбираются при создании функции. Это менее эффективно определения функции при помощи выражения function или инструкции function и вызова её внутри вашего кода, поскольку такие функции разбираются вместе с остальным кодом.

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

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

    Вызов констуктора Function как функции (без использования оператора new) имеет тот же самый эффект, что и вызов его как констуктора.

    Свойства и методы объекта Function

    Глобальный объект Function не имеет собственных методов или свойств, однако, поскольку он сам является функцией, он наследует некоторые методы и свойства через цепочку прототипов объекта Function.prototype.

    Прототип объекта Function

    Свойства

    Function.arguments
    Массив, соответствующий аргументам, переданным в функцию. Это устаревшее свойство Function, используйте вместо него объект arguments, доступный внутри функции.
    Function.arity
    Использовалось для определения количества аргументов, ожидаемых функцией, но было удалено. Вместо него используйте свойство length.
    Function.caller
    Определяет функцию, вызвавшую текущую выполняющуюся функцию.
    Function.length
    Определяет количество аргументов, ожидаемых функцией.
    Function.name
    Имя функции.
    Function.displayName
    Отображаемое имя функции.
    Function.prototype.constructor
    Определяет функцию, создающую прототип объекта. Смотрите документацию по Object.prototype.constructor.

    Методы

    Function.prototype.apply()
    Применяет метод одного объекта в контексте другого объекта (вызывающего объекта); аргументы передаются объектом Array.
    Function.prototype.bind()
    Создаёт новую функцию, которая, при вызове, самостоятельно вызывает эту функцию в контексте предоставленного значения, с данной последовательностью аргументов, предшествующих любым аргументам, переданным в новую функцию при её вызове.
    Function.prototype.call()
    Вызывает (выполняет) метод одного объекта в контексте другого объекта (вызывающего объекта); аргументы передаются как есть.
    Function.prototype.isGenerator()
    Возвращает true, если функция является генератором; в противном случае возвращает false.
    Function.prototype.toSource()
    Возвращает строку, представляющую исходный код функции. Переопределяет метод Object.prototype.toSource.
    Function.prototype.toString()
    Возвращает строку, представляющую исходный код функции. Переопределяет метод Object.prototype.toString.

    Экземпляры объекта Function

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

    Примеры

    Пример: указание аргументов в конструкторе Function

    Следующий код создаёт объект Function, который принимает два аргумента.

    // Пример может быть запущен непосредственно в вашей консоли JavaScript
    
    // Создаём функцию, принимающую два аргумента, и возвращающую их сумму
    var adder = new Function('a', 'b', 'return a + b');
    
    // Вызываем функцию
    adder(2, 6);
    // > 8
    

    Аргуметы "a" и "b" являются именами формальных аргументов, которые используются в теле функции, "return a + b".

    Пример: рекурсивное сокращение для массового изменения DOM

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

    <!doctype html>
    <html>
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Пример MDN - рекурсивное сокращение для массового изменения DOM</title>
    <script type="text/javascript">
    var domQuery = (function() {
      var aDOMFunc = [
        Element.prototype.removeAttribute,
        Element.prototype.setAttribute,
        CSSStyleDeclaration.prototype.removeProperty,
        CSSStyleDeclaration.prototype.setProperty
      ];
    
      function setSomething(bStyle, sProp, sVal) {
        var bSet = Boolean(sVal), fAction = aDOMFunc[bSet | bStyle << 1],
            aArgs = Array.prototype.slice.call(arguments, 1, bSet ? 3 : 2),
            aNodeList = bStyle ? this.cssNodes : this.nodes;
    
        if (bSet && bStyle) { aArgs.push(''); }
        for (
          var nItem = 0, nLen = this.nodes.length;
          nItem < nLen;
          fAction.apply(aNodeList[nItem++], aArgs)
        );
        this.follow = setSomething.caller;
        return this;
      }
    
      function setStyles(sProp, sVal) { return setSomething.call(this, true, sProp, sVal); }
      function setAttribs(sProp, sVal) { return setSomething.call(this, false, sProp, sVal); }
      function getSelectors() { return this.selectors; };
      function getNodes() { return this.nodes; };
    
      return (function(sSelectors) {
        var oQuery = new Function('return arguments.callee.follow.apply(arguments.callee, arguments);');
        oQuery.selectors = sSelectors;
        oQuery.nodes = document.querySelectorAll(sSelectors);
        oQuery.cssNodes = Array.prototype.map.call(oQuery.nodes, function(oInlineCSS) { return oInlineCSS.style; });
        oQuery.attributes = setAttribs;
        oQuery.inlineStyle = setStyles;
        oQuery.follow = getNodes;
        oQuery.toString = getSelectors;
        oQuery.valueOf = getNodes;
        return oQuery;
      });
    })();
    </script>
    </head>
    
    <body>
    
    <div class="testClass">Lorem ipsum</div>
    <p>Некоторый текст</p>
    <div class="testClass">dolor sit amet</div>
    
    <script type="text/javascript">
    domQuery('.testClass')
      .attributes('lang', 'en')('title', 'Risus abundat in ore stultorum')
      .inlineStyle('background-color', 'black')('color', 'white')('width', '100px')('height', '50px');
    </script>
    </body>
    
    </html>
    

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

    Спецификация Статус Комментарии
    ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.0.
    ECMAScript 5.1 (ECMA-262)
    Определение 'Function' в этой спецификации.
    Стандарт  
    ECMAScript 6 (ECMA-262)
    Определение 'Function' в этой спецификации.
    Кандидат в рекомендации  

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

    Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Базовая поддержка (Да) (Да) (Да) (Да) (Да)
    Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

    Смотрите также

    Метки документа и участники

    Contributors to this page: Mingun, teoli, Skorney
    Обновлялась последний раз: Mingun,