W3cubDocs

/Web APIs

WEBGL_lose_context extension

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.

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:

js

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

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
WEBGL_lose_context 2618 17 2219–58 No 1515 8 ≤37≤37 2618 2219–58 1414 8 1.51.0
loseContext 26 17 2219–58 No 15 8 4.4 26 2219–58 14 8 1.5
restoreContext 26 17 2219–58 No 15 8 4.4 26 2219–58 14 8 1.5

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WEBGL_lose_context