HTMLCanvasElement：transferControlToOffscreen() 方法

基线 2023

新可用

自 2023 年 3 月起，此功能可在最新的设备和浏览器版本中使用。此功能可能在较旧的设备或浏览器中不起作用。

HTMLCanvasElement.transferControlToOffscreen() 方法将控制权转移到 OffscreenCanvas 对象，无论是在主线程上还是在工作线程上。

语法

js
transferControlToOffscreen()

参数

无。

返回值

一个 OffscreenCanvas 对象。

示例

以下示例演示如何将控制权转移到主线程上的 OffscreenCanvas 对象。

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

// Some drawing using the gl context…

以下示例演示如何将控制权转移到工作线程上的 OffscreenCanvas 对象。

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

规范

规范
HTML 标准
# dom-canvas-transfercontroltooffscreen-dev

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅