maxBy.js (991B)
1 var baseExtremum = require('./_baseExtremum'), 2 baseGt = require('./_baseGt'), 3 baseIteratee = require('./_baseIteratee'); 4 5 /** 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). 9 * 10 * @static 11 * @memberOf _ 12 * @since 4.0.0 13 * @category Math 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. 17 * @example 18 * 19 * var objects = [{ 'n': 1 }, { 'n': 2 }]; 20 * 21 * _.maxBy(objects, function(o) { return o.n; }); 22 * // => { 'n': 2 } 23 * 24 * // The `_.property` iteratee shorthand. 25 * _.maxBy(objects, 'n'); 26 * // => { 'n': 2 } 27 */ 28 function maxBy(array, iteratee) { 29 return (array && array.length) 30 ? baseExtremum(array, baseIteratee(iteratee, 2), baseGt) 31 : undefined; 32 } 33 34 module.exports = maxBy;