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
- WebGLRenderingContext.isContextLost()
- Events:
webglcontextlost,webglcontextrestored,webglcontextcreationerror