www.aleph1.co.uk Git - yaffs-website/blob - node_modules/node-sass/node_modules/lodash/unionBy.js

   1 var baseFlatten = require('./_baseFlatten'),
   2     baseIteratee = require('./_baseIteratee'),
   3     baseRest = require('./_baseRest'),
   4     baseUniq = require('./_baseUniq'),
   5     isArrayLikeObject = require('./isArrayLikeObject'),
   6     last = require('./last');
   7
   8 /**
   9  * This method is like `_.union` except that it accepts `iteratee` which is
  10  * invoked for each element of each `arrays` to generate the criterion by
  11  * which uniqueness is computed. Result values are chosen from the first
  12  * array in which the value occurs. The iteratee is invoked with one argument:
  13  * (value).
  14  *
  15  * @static
  16  * @memberOf _
  17  * @since 4.0.0
  18  * @category Array
  19  * @param {...Array} [arrays] The arrays to inspect.
  20  * @param {Function} [iteratee=_.identity] The iteratee invoked per element.
  21  * @returns {Array} Returns the new array of combined values.
  22  * @example
  23  *
  24  * _.unionBy([2.1], [1.2, 2.3], Math.floor);
  25  * // => [2.1, 1.2]
  26  *
  27  * // The `_.property` iteratee shorthand.
  28  * _.unionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
  29  * // => [{ 'x': 1 }, { 'x': 2 }]
  30  */
  31 var unionBy = baseRest(function(arrays) {
  32   var iteratee = last(arrays);
  33   if (isArrayLikeObject(iteratee)) {
  34     iteratee = undefined;
  35   }
  36   return baseUniq(baseFlatten(arrays, 1, isArrayLikeObject, true), baseIteratee(iteratee, 2));
  37 });
  38
  39 module.exports = unionBy;