HTMLCanvasElement: transferControlToOffscreen() Methode

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die HTMLCanvasElement.transferControlToOffscreen() Methode überträgt die Kontrolle an ein OffscreenCanvas Objekt, entweder im Haupt-Thread oder in einem Worker.

Syntax

js
transferControlToOffscreen()

Parameter

Keine.

Rückgabewert

Ein OffscreenCanvas Objekt.

Beispiele

Das folgende Beispiel zeigt, wie die Kontrolle an ein OffscreenCanvas Objekt im Haupt-Thread übertragen wird.

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

// Some drawing using the gl context…

Das folgende Beispiel zeigt, wie die Kontrolle an ein OffscreenCanvas Objekt in einem Worker übertragen wird.

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

Spezifikationen

Specification
HTML Standard
# dom-canvas-transfercontroltooffscreen-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch