HTMLCanvasElement: Methode transferControlToOffscreen()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
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
Siehe auch
- Das Interface, das diese Methode definiert,
HTMLCanvasElement OffscreenCanvas