HTMLCanvasElement: transferControlToOffscreen() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨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]);