MDN self-hosted library · e01.org

WEBGL_lose_context extension

WebGL

WebGL

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 Using WebGL extensions.

[!NOTE] This extension is available to both, WebGL1 and WebGL2 contexts.

Instance 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

See also