WEBGL_lose_context

The WEBGL_lose_context extension is part of the WebGL API and exposes functions to simulate losing and restoring a WebGLRenderingContext.

WebGL extensions are available using the WebGLRenderingContext.getExtension() method. For more information, see also Using Extensions in the WebGL tutorial.

Availability: This extension is available to both, WebGL1 and WebGL2 contexts.

Methods

WEBGL_lose_context.loseContext()
Simulates losing the context.
WEBGL_lose_context.restoreContext()
Simulates restoring the context.

Examples

With this extension, you can simulate the webglcontextlost and webglcontextrestored events:

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' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Edge Firefox Internet Explorer Opera Safari Servo
Basic Support??22.01????
Feature Android Chrome for Android Edge Mobile Firefox for Android IE Mobile Opera Mobile Safari Mobile
Basic Support???????

1. This extension was prefixed with MOZ_ from version 19 to version 21.

See also

Document Tags and Contributors

 Contributors to this page: teoli, fscholz
 Last updated by: teoli,