WorkerGlobalScope: structuredClone() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年3月以降、すべてのブラウザーで利用可能です。
メモ: この機能はウェブワーカー内でのみ利用可能です。
structuredClone() は WorkerGlobalScope のメソッドで、指定された値のディープコピーを、構造化複製アルゴリズムを用いて生成します。
このメソッドでは、元の値の移譲可能オブジェクトを、新しいオブジェクトにクローンするのではなく、移譲することもできます。 移譲されたオブジェクトは元のオブジェクトから切り離され、新しいオブジェクトに関連付けられます。元のオブジェクトからはもうアクセスできなくなります。
構文
js
structuredClone(value)
structuredClone(value, options)
引数
value-
複製されるオブジェクトです。 これはあらゆる構造化複製可能型です。
options省略可-
以下のプロパティを持つオブジェクトです。
transfer
-
移譲可能オブジェクトの配列で、複製するのではなく移動するオブジェクトを指定します。
返値
返値は元の value のディープコピーです。
例外
DataCloneErrorDOMException-
入力値にシリアライズ可能でない部分があった場合に発生します。
解説
この関数の詳細は Window.structuredClone() を参照してください。
例
例については Window.structuredClone() を参照してください。
仕様書
| 仕様書 |
|---|
| HTML # dom-structuredclone |