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

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

Examples

With this method, you can simulate the webglcontextlost event:

JavaScript
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

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support ? 19 (19) ? ? ?
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? 19.0 (19) ? ? ?

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/webgl_lose_context/losecontext

API Method Reference WebGL WebGL extension