WEBGL_lose_context.loseContext()

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

It triggers the steps described in the WebGL specification for handling context lost. The context will remain lost until WEBGL_lose_context.restoreContext() is called.

Syntax

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

Examples

With this method, you can simulate the webglcontextlost event:

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

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

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

// WebGLContextEvent event with type "webglcontextlost" is logged.

Specifications

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

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
loseContextChrome 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 YesEdge Mobile No support NoFirefox Android ? Opera Android Full support YesSafari iOS ? Samsung Internet Android Full support Yes

Legend

Full support  
Full support
No support  
No 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

Document Tags and Contributors

Contributors to this page: mdnwebdocs-bot, fscholz, nmve, teoli
Last updated by: mdnwebdocs-bot,