HTMLCanvasElement: transferControlToOffscreen() メソッド

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

構文

js

transferControlToOffscreen()

引数

なし。

返値

OffscreenCanvas (en-US) オブジェクト。

例

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

js

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

// Some drawing using the gl context…

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

js

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

仕様書

Specification
HTML Standard
# dom-canvas-transfercontroltooffscreen-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報