1 var baseExtremum = require('./_baseExtremum'),
2 baseGt = require('./_baseGt'),
3 baseIteratee = require('./_baseIteratee');
6 * This method is like `_.max` except that it accepts `iteratee` which is
7 * invoked for each element in `array` to generate the criterion by which
8 * the value is ranked. The iteratee is invoked with one argument: (value).
14 * @param {Array} array The array to iterate over.
15 * @param {Function} [iteratee=_.identity] The iteratee invoked per element.
16 * @returns {*} Returns the maximum value.
19 * var objects = [{ 'n': 1 }, { 'n': 2 }];
21 * _.maxBy(objects, function(o) { return o.n; });
24 * // The `_.property` iteratee shorthand.
25 * _.maxBy(objects, 'n');
28 function maxBy(array, iteratee) {
29 return (array && array.length)
30 ? baseExtremum(array, baseIteratee(iteratee, 2), baseGt)
34 module.exports = maxBy;