#

API Docs for: 3.10.3
Show: Inherited Protected Private Deprecated

# File: collection/js/invoke.js

    /**
    @module collection
    @submodule array-invoke
    */

    /**
    Executes a named method on each item in an array of objects. Items in the array
    that do not have a function by that name will be skipped.

    @example

        Y.Array.invoke(arrayOfDrags, 'plug', Y.Plugin.DDProxy);

    @method invoke
    @param {Array} items Array of objects supporting the named method.
    @param {String} name the name of the method to execute on each item.
    @param {Any} [args*] Any number of additional args are passed as parameters to
      the execution of the named method.
    @return {Array} All return values, indexed according to the item index.
    @static
    @for Array
    **/
    Y.Array.invoke = function(items, name) {
        var args = Y.Array(arguments, 2, true),
            isFunction = Y.Lang.isFunction,
            ret = [];

        Y.Array.each(Y.Array(items), function(item, i) {
            if (item && isFunction(item[name])) {
                ret[i] = item[name].apply(item, args);
            }
        });

        return ret;
    };