结构化克隆算法

结构化克隆不支持的功能

• Function 对象无法被结构化克隆算法复制；尝试这样做会抛出 DataCloneError 异常。
• 克隆 DOM 节点同样会抛出 DataCloneError 异常。
• 某些对象属性不被保留
  • RegExp 对象的 lastIndex 属性不被保留。
  • 属性描述符、setter、getter 以及类似的元数据功能不会被复制。例如，如果一个对象使用 属性描述符标记为只读，那么在复制的对象中它将是读/写的，因为这是默认行为。
  • 原型链不会被遍历或复制。
  • 类私有元素不会被复制。（尽管内置类型的内部字段可能会。）

支持的类型

JavaScript 类型

• Array
• ArrayBuffer
• Boolean
• DataView
• Date
• Error 类型（但请参阅下面的 错误类型）。
• Map
• Number
• Object 对象：但仅限于普通对象（例如，来自对象字面量）。
• 原始类型，除了 symbol。
• RegExp：但请注意 lastIndex 不被保留。
• Set
• String
• TypedArray

错误类型

对于 Error 类型，错误名称必须是以下之一：Error、EvalError、RangeError、ReferenceError、SyntaxError、TypeError、URIError（否则将设置为 "Error"）。

浏览器必须序列化 name 和 message 属性，并期望序列化错误的其他“有趣”属性，如 stack、cause 等。

AggregateError 的支持预计将在 whatwg/html#5749 中添加到规范中（并且在某些浏览器中已得到支持）。

Web/API 类型

• AudioData
• Blob
• CropTarget
• CryptoKey
• DOMException：浏览器必须序列化 name 和 message 属性。其他属性也可能被序列化/克隆。
• DOMMatrix
• DOMMatrixReadOnly
• DOMPoint
• DOMPointReadOnly
• DOMQuad
• DOMRect
• DOMRectReadOnly
• EncodedAudioChunk
• EncodedVideoChunk
• FencedFrameConfig
• File
• FileList
• FileSystemDirectoryHandle
• FileSystemFileHandle
• FileSystemHandle
• GPUCompilationInfo
• GPUCompilationMessage
• GPUPipelineError
• ImageBitmap
• ImageData
• RTCCertificate
• RTCEncodedAudioFrame
• RTCEncodedVideoFrame
• VideoFrame
• WebTransportError

另见

• HTML 规范：结构化数据的安全传递
• 可转移对象
• Window.structuredClone()
• WorkerGlobalScope.structuredClone()
• window.postMessage()
• Web Workers
• IndexedDB