WorkerGlobalScope：structuredClone() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/zh-cn/web/api/workerglobalscope/index.md)

备注： 此特性仅在 Web Worker 中可用。

WorkerGlobalScope 接口的 structuredClone() 方法使用结构化克隆算法将给定的值进行深拷贝。

该方法还支持把原值中的可转移对象转移（而不是拷贝）到新对象上。可转移对象与原始对象分离并附加到新对象；它们将无法在原始对象中被访问。

语法

js
structuredClone(value)
structuredClone(value, options)

参数

value

被克隆的对象。可以是任何结构化克隆支持的类型。

options 可选

一个具有以下属性的对象：

transfer

一个可转移对象的数组，里面的对象将被移动而不是克隆到返回的对象上。

返回值

原始值（value）的深拷贝。

异常

DataCloneError DOMException

如果输入值的任一部分不可序列化，则抛出该异常。

描述

参见 Window.structuredClone() 以获取该函数的详细信息。

示例

参见 Window.structuredClone() 以获取示例。

规范

Specification
HTML Standard
# dom-structuredclone

浏览器兼容性

BCD tables only load in the browser

参见