W3cubDocs

/DOM

HTMLCanvasElement.transferControlToOffscreen

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 compatibilityUpdate compatibility data on GitHub

	Desktop
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic support	69	No	44 Disabled 44 Disabled Disabled From version 44: this feature is behind the `gfx.offscreencanvas.enabled` preference. To change preferences in Firefox, visit about:config.	No	No	No