lodash 源码阅读-clone

源码

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

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

/**
 * Creates a shallow clone of `value`.
 *
 * **Note:** This method is loosely based on the
 * [structured clone algorithm](https://mdn.io/Structured_clone_algorithm)
 * and supports cloning arrays, array buffers, booleans, date objects, maps,
 * numbers, `Object` objects, regexes, sets, strings, symbols, and typed
 * arrays. The own enumerable properties of `arguments` objects are cloned
 * as plain objects. Object inheritance is preserved. An empty object is
 * returned for uncloneable values such as error objects, functions, DOM nodes,
 * and WeakMaps.
 *
 * @since 0.1.0
 * @category Lang
 * @param {*} value The value to clone.
 * @returns {*} Returns the cloned value.
 * @see cloneDeep
 * @example
 *
 * const objects = [{ 'a': 1 }, { 'b': 2 }]
 *
 * const shallow = clone(objects)
 * console.log(shallow[0] === objects[0])
 * // => true
 */
function clone(value) {
  return baseClone(value, CLONE_SYMBOLS_FLAG)
}

export default clone

补充知识:

The structured clone algorithm

结构化克隆算法

结构化克隆算法是由 HTML5 规范规定的用于拷贝复杂 JavaScript 对象的一种算法。

在通过 postmessage() 在 Workers 之间传送数据时或者在 indexDB 存储对象时,内部调用。

它通过递归输入对象创建克隆,同时保留一份之前访问过的引用的 map 映射,避免无限遍历循环。

不适用结构化克隆算法的

  • Error 和 Function 对象不能通过结构化克隆算法复制。否则会抛出 DATA_CLONE_ERR 的错误。
  • 克隆 DOM 节点也会抛出类似 DATA_CLONE_ERR 这样的错误。
  • 对象的某些参数不会被保留:
    • 正则 RegExp 的 lastIndex 字段不会被保留
    • 属性描述器(property descriptors)、setters、getters(以及类元数据特征)不会被复制。比如一个对象通过属性描述器标记为 只读(read-only),复制后会变成可读可写(read-write),因为这是默认设置。
    • 原型链不会被复制

支持的类型

对象类型 备注
所有的原始类型 不包含 symbols
布尔对象(Boolean)
String 对象
Date
RegExp lastIndex 字段不会保留
Blob
File
FileList
ArrayBuffer
ArrayBufferView
ImageBitmap
ImageData
Array
Object 仅包括纯对象(使用 {} 或 new Object 创建的对象)
Map
Set

baseClone

baseClone

Last Updated: 7/20/2019, 3:12:48 PM