HTMLCanvasElement: Methode transferControlToOffscreen()

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 Methode HTMLCanvasElement.transferControlToOffscreen() ü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.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn:

  • das Canvas durch Aufrufen von HTMLCanvasElement.getContext() in einen Kontextmodus versetzt wurde.
  • das Canvas seine Kontrolle bereits auf offscreen übertragen hat.

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
# dom-canvas-transfercontroltooffscreen-dev

Browser-Kompatibilität

Siehe auch