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 auf ein OffscreenCanvas-Objekt, entweder im Haupt-Thread oder in einem Worker.
Syntax
js
transferControlToOffscreen()
Parameter
Keine.
Rückgabewert
Ein OffscreenCanvas-Objekt.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn:
- dem Canvas ein Kontextmodus durch Aufruf von
HTMLCanvasElement.getContext()zugewiesen wurde. - das Canvas seine Kontrolle durch Aufruf von
HTMLCanvasElement.transferControlToOffscreen()in den Offscreen-Modus übertragen hat.
- dem Canvas ein Kontextmodus durch Aufruf von
Beispiele
Das folgende Beispiel zeigt, wie die Kontrolle auf 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 auf 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
- Das Interface, das diese Methode definiert,
HTMLCanvasElement OffscreenCanvas