lodash / lodash

Cannot retrieve contributors at this time

40 lines (37 sloc) 1.1 KB

Raw Blame

	import baseClone from './.internal/baseClone.js'

	/** Used to compose bitmasks for cloning. */
	const CLONE_SYMBOLS_FLAG = 4

	/**
	* This method is like `clone` except that it accepts `customizer` which
	* is invoked to produce the cloned value. If `customizer` returns `undefined`,
	* cloning is handled by the method instead. The `customizer` is invoked with
	* one argument (value).
	*
	* @since 4.0.0
	* @category Lang
	* @param {*} value The value to clone.
	* @param {Function} [customizer] The function to customize cloning.
	* @returns {*} Returns the cloned value.
	* @see cloneDeepWith
	* @example
	*
	* function customizer(value) {
	* if (isElement(value)) {
	* return value.cloneNode(false)
	* }
	* }
	*
	* const el = cloneWith(document.body, customizer)
	*
	* console.log(el === document.body)
	* // => false
	* console.log(el.nodeName)
	* // => 'BODY'
	* console.log(el.childNodes.length)
	* // => 0
	*/
	function cloneWith(value, customizer) {
	customizer = typeof customizer === 'function' ? customizer : undefined
	return baseClone(value, CLONE_SYMBOLS_FLAG, customizer)
	}

	export default cloneWith

lodash/cloneWith.js / Jump to Code definitions cloneWith Function Code navigation index up-to-date