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