WorkerGlobalScope:structuredClone() 方法

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2022 年 3 月起,它已在各瀏覽器中可用。

注意:此功能僅在 Web Workers 中可用。

structuredClone() 方法是 WorkerGlobalScope 介面的一部分,它使用 structured clone 演算法 為給定的值建立一個深複製

該方法還允許將原始值中的可轉移物件轉移到新物件,而不是進行克隆。轉移的物件將從原始物件中分離,並附加到新物件;它們將不再能在原始物件中訪問。

語法

js
structuredClone(value)
structuredClone(value, options)

引數

value

要克隆的物件。這可以是任何支援結構化克隆的型別

options 可選

具有以下屬性的物件:

transfer

一個可轉移物件陣列,它們將被移動(而不是克隆)到返回的物件中。

返回值

原始 value深複製

異常

DataCloneError DOMException

如果輸入值的任何部分不可序列化,則丟擲此錯誤。

描述

有關此函式的詳細資訊,請參閱 Window.structuredClone()

示例

有關示例,請參閱 Window.structuredClone()

規範

規範
HTML
# dom-structuredclone

瀏覽器相容性

另見