The WebGLRenderingContext.isContextLost()
method returns a boolean value indicating whether or not the WebGL context has been lost and must be re-established before rendering can resume.
The WebGLRenderingContext.isContextLost()
method returns a boolean value indicating whether or not the WebGL context has been lost and must be re-established before rendering can resume.
js
isContextLost()
None.
A boolean value which is true
if the context is lost, or false
if not.
There are several reasons why a WebGL context may be lost, making it necessary to re-establish the context before resuming rendering. Examples include:
For example, when checking for program linking success, you could also check if the context is not lost:
js
gl.linkProgram(program); if (!gl.getProgramParameter(program, gl.LINK_STATUS) && !gl.isContextLost()) { const info = gl.getProgramInfoLog(program); console.log(`Error linking program:\n${info}`); }
Specification |
---|
WebGL Specification # 5.14.13 |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
isContextLost |
9 | 12 | 4 | 11 | 12 | 5.1 | 4.4.3 | 25 | 4 | 12 | 8 | 1.5 |
WebGLContextEvent
signals changes in the context state.
© 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/WebGLRenderingContext/isContextLost