Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 MethodeHTMLCanvasElement.transferControlToOffscreen() überträgt die Kontrolle an einOffscreenCanvas-Objekt, entweder im Haupt-Thread oder in einem Worker.
Syntax
js
transferControlToOffscreen()Parameter
Keine.
Rückgabewert
EinOffscreenCanvas-Objekt.
Ausnahmen
InvalidStateErrorDOMExceptionWird 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 einOffscreenCanvas-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 einOffscreenCanvas-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