difference.js 996 B

12345678910111213141516171819202122232425262728293031
  1. var baseDifference = require('./_baseDifference'),
  2. baseFlatten = require('./_baseFlatten'),
  3. isArrayLikeObject = require('./isArrayLikeObject'),
  4. rest = require('./rest');
  5. /**
  6. * Creates an array of unique `array` values not included in the other given
  7. * arrays using [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
  8. * for equality comparisons. The order of result values is determined by the
  9. * order they occur in the first array.
  10. *
  11. * @static
  12. * @memberOf _
  13. * @since 0.1.0
  14. * @category Array
  15. * @param {Array} array The array to inspect.
  16. * @param {...Array} [values] The values to exclude.
  17. * @returns {Array} Returns the new array of filtered values.
  18. * @see _.without, _.xor
  19. * @example
  20. *
  21. * _.difference([2, 1], [2, 3]);
  22. * // => [1]
  23. */
  24. var difference = rest(function(array, values) {
  25. return isArrayLikeObject(array)
  26. ? baseDifference(array, baseFlatten(values, 1, isArrayLikeObject, true))
  27. : [];
  28. });
  29. module.exports = difference;