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.

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:

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

canvas.addEventListener('webglcontextlost', (event) => {
  console.log(event);
});

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

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

Specifications

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.

See also

• WebGLRenderingContext.isContextLost()
• Events: webglcontextlost, webglcontextrestored, webglcontextcreationerror