HTMLCanvasElement: Methode transferControlToOffscreen()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
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
InvalidStateErrorDOMException-
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.
- das Canvas durch Aufrufen von
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
| Spezifikation |
|---|
| HTML # dom-canvas-transfercontroltooffscreen-dev |
Browser-Kompatibilität
Siehe auch
- Das Interface, das diese Methode definiert,
HTMLCanvasElement OffscreenCanvas