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
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
| Specification |
|---|
| HTML # dom-canvas-transfercontroltooffscreen-dev |
Browser-Kompatibilität
Loading…
Siehe auch
- Das Interface, das diese Methode definiert,
HTMLCanvasElement OffscreenCanvas