www.aleph1.co.uk Git - yaffs-website/blob - node_modules/sass-graph/node_modules/lodash/cloneWith.js

   1 var baseClone = require('./_baseClone');
   2
   3 /** Used to compose bitmasks for cloning. */
   4 var CLONE_SYMBOLS_FLAG = 4;
   5
   6 /**
   7  * This method is like `_.clone` except that it accepts `customizer` which
   8  * is invoked to produce the cloned value. If `customizer` returns `undefined`,
   9  * cloning is handled by the method instead. The `customizer` is invoked with
  10  * up to four arguments; (value [, index|key, object, stack]).
  11  *
  12  * @static
  13  * @memberOf _
  14  * @since 4.0.0
  15  * @category Lang
  16  * @param {*} value The value to clone.
  17  * @param {Function} [customizer] The function to customize cloning.
  18  * @returns {*} Returns the cloned value.
  19  * @see _.cloneDeepWith
  20  * @example
  21  *
  22  * function customizer(value) {
  23  *   if (_.isElement(value)) {
  24  *     return value.cloneNode(false);
  25  *   }
  26  * }
  27  *
  28  * var el = _.cloneWith(document.body, customizer);
  29  *
  30  * console.log(el === document.body);
  31  * // => false
  32  * console.log(el.nodeName);
  33  * // => 'BODY'
  34  * console.log(el.childNodes.length);
  35  * // => 0
  36  */
  37 function cloneWith(value, customizer) {
  38   customizer = typeof customizer == 'function' ? customizer : undefined;
  39   return baseClone(value, CLONE_SYMBOLS_FLAG, customizer);
  40 }
  41
  42 module.exports = cloneWith;