HTMLCanvasElement: transferControlToOffscreen() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年3月以降、すべてのブラウザーで利用可能です。

HTMLCanvasElement.transferControlToOffscreen() メソッドは、メインスレッドまたはワーカーの OffscreenCanvas オブジェクトへ制御を委譲します。

構文

transferControlToOffscreen()

引数

なし。

返値

OffscreenCanvas オブジェクト。

例

次の例は、メインスレッド上の OffscreenCanvas オブジェクトに制御を移譲する方法です。

const htmlCanvas = document.createElement("canvas");
const offscreen = htmlCanvas.transferControlToOffscreen();
const gl = offscreen.getContext("webgl");

// Some drawing using the gl context…

次の例は、ワーカー上の OffscreenCanvas オブジェクトに制御を移す方法を示しています。

const offscreen = document.querySelector("canvas").transferControlToOffscreen();
const worker = new Worker("myworkerurl.js");
worker.postMessage({ canvas: offscreen }, [offscreen]);