Firefox Tomorrow

webgl extension

WEBGL_lose_context extension

View on MDN ↗

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 getExtension() method. For more information, see also Using Extensions in the WebGL tutorial.

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

Instance methods

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

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also