lodash/utility/method.js

define(['../internal/invokePath', '../function/restParam'], function(invokePath, restParam) {

  /**
   * Creates a function which invokes the method at `path` on a given object.
   *
   * @static
   * @memberOf _
   * @category Utility
   * @param {Array|string} path The path of the method to invoke.
   * @returns {Function} Returns the new function.
   * @example
   *
   * var objects = [
   *   { 'a': { 'b': { 'c': _.constant(2) } } },
   *   { 'a': { 'b': { 'c': _.constant(1) } } }
   * ];
   *
   * _.map(objects, _.method('a.b.c'));
   * // => [2, 1]
   *
   * _.invoke(_.sortBy(objects, _.method(['a', 'b', 'c'])), 'a.b.c');
   * // => [1, 2]
   */
  var method = restParam(function(path, args) {
    return function(object) {
      return invokePath(object, path, args);
    };
  });

  return method;
});