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_contextThe definition of 'WEBGL_lose_context.loseContext' in that specification. | Recommendation | Initial definition. |
Browser compatibility
The compatibility table in 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
loseContext
|
Chrome
Full support Yes |
Edge
Full support 17 |
Firefox Full support 22 Full support 22 No support 19 — 58 Prefixed' Implemented with the vendor prefix: MOZ_ |
IE
? |
Opera
Full support Yes |
Safari
? |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
? |
Opera Android
Full support Yes |
Safari 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
WebGLRenderingContext.isContextLost()
- Events:
webglcontextlost
,webglcontextrestored
,webglcontextcreationerror
WEBGL_lose_context.loseContext() by Mozilla Contributors is licensed under CC-BY-SA 2.5.