WEBGL_lose_context.restoreContext()

The WEBGL_lose_context.restoreContext() method is part of the WebGL API and allows you to simulate restoring the context of a WebGLRenderingContext object.

Syntax

gl.getExtension('WEBGL_lose_context').restoreContext();

Errors thrown

  • INVALID_OPERATION if the context was not lost.

Examples

With this method, you can simulate the webglcontextrestored event:

var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');

canvas.addEventListener('webglcontextrestored', function(e) {
  console.log(e);
}, false);

gl.getExtension('WEBGL_lose_context').restoreContext();

Specifications

Specification Status Comment
WEBGL_lose_context
The definition of 'WEBGL_lose_context.loseContext' in that specification.
Recommendation Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
restoreContextChrome Full support YesEdge Full support 17Firefox Full support 22
Full support 22
No support 19 — 58
Prefixed
Prefixed Implemented with the vendor prefix: MOZ_
IE ? Opera Full support YesSafari ? WebView Android Full support YesChrome Android Full support YesFirefox Android ? Opera Android Full support YesSafari iOS ? Samsung Internet Android Full support Yes

Legend

Full support
Full support
Compatibility unknown
Compatibility unknown
Requires a vendor prefix or different name for use.
Requires a vendor prefix or different name for use.

See also