HTMLCanvasElement: transferControlToOffscreen() 方法
HTMLCanvasElement.transferControlToOffscreen() 方法將控制權轉移到 OffscreenCanvas 物件，該物件可能位於主執行緒或 worker 中。
語法
js
transferControlToOffscreen()
引數
無。
返回值
一個 OffscreenCanvas 物件。
異常
InvalidStateErrorDOMException-
如果發生以下情況，則會丟擲錯誤：
- 透過呼叫
HTMLCanvasElement.getContext()為 canvas 設定了上下文模式 - canvas 已將其控制權轉移到螢幕外。
- 透過呼叫
示例
以下示例顯示瞭如何將控制權轉移到主執行緒中的 OffscreenCanvas 物件。
js
const htmlCanvas = document.createElement("canvas");
const offscreen = htmlCanvas.transferControlToOffscreen();
const gl = offscreen.getContext("webgl");
// Some drawing using the gl context…
以下示例顯示瞭如何將控制權轉移到 worker 中的 OffscreenCanvas 物件。
js
const offscreen = document.querySelector("canvas").transferControlToOffscreen();
const worker = new Worker("my-worker-url.js");
worker.postMessage({ canvas: offscreen }, [offscreen]);
規範
| 規範 |
|---|
| HTML # dom-canvas-transfercontroltooffscreen-dev |
瀏覽器相容性
載入中…
另見
- 定義此方法的介面：
HTMLCanvasElement OffscreenCanvas