HTMLCanvasElement: метод transferControlToOffscreen()

Метод HTMLCanvasElement.transferControlToOffscreen() передает управление объекту OffscreenCanvas, либо на основном потоке, либо на потоке-воркере.

Нет.

Объект OffscreenCanvas.

InvalidStateError DOMException

Выбрасывается, если:

• холст был настроен в режим контекста с помощью вызова HTMLCanvasElement.getContext()
• холст передал управление в offscreen с помощью вызова HTMLCanvasElement.transferControlToOffscreen().

Следующий пример показывает, как передать управление объекту 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("my-worker-url.js");
worker.postMessage({ canvas: offscreen }, [offscreen]);

• Интерфейс, определяющий этот метод, HTMLCanvasElement
• OffscreenCanvas