This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The HTMLCanvasElement.transferControlToOffscreen() method transfers control to an OffscreenCanvas object, either on the main thread or on a worker.
Syntax
OffscreenCanvas HTMLCanvasElement.transferControlToOffscreen()
Return value
An OffscreenCanvas object.
Examples
var htmlCanvas = document.createElement('canvas');
var offscreen = htmlCanvas.transferControlToOffscreen();
var gl = offscreen.getContext('webgl');
// ... some drawing using the gl context ...
// Push frames back to the original HTMLCanvasElement
gl.commit();
Specifications
Currently drafted as a proposal in the OffscreenCanvas specification.
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | No | No | 441 | No | No | No |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | No | No | No | 441 | No | No | No |
1. From version 44: this feature is behind the gfx.offscreencanvas.enabled preference. To change preferences in Firefox, visit about:config.
See also
- The interface defining this method,
HTMLCanvasElement OffscreenCanvasWebGLRenderingContext.commit()