WebGLContextEvent

The WebContextEvent interface is part of the WebGL API and is an interface for an event that is generated in response to a status change to the WebGL rendering context.

Inheritance

This interface inherits properties and methods from its parent interface, Event.

Properties

This interface inherits properties from its parent interface, Event.

WebGLContextEvent.statusMessage
A read-only property containing additional information about the event.

Methods

This interface doesn't define any own methods, but inherits methods from its parent interface, Event.

Examples

With the help of the WEBGL_lose_context extension, you can simulate the webglcontextlost and webglcontextrestored events:

var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
canvas.addEventListener('webglcontextlost', function(e) {
  console.log(e); 
}, false);
gl.getExtension('WEBGL_lose_context').loseContext();
// WebGLContextEvent event with type "webglcontextlost" is logged.

Specifications

Specification Status Comment
WebGL 1.0
The definition of 'WebGLContextEvent' in that specification.
Recommendation Initial definition.

Browser compatibility

FeatureChromeFirefoxEdgeInternet ExplorerOperaSafari
Basic Support9491211125.1
Available in workers(No)491(No)(No)(No)(No)
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)25(Yes)4911128.1
Available in workers(No)(No)(No)(No)(No)(No)(No)

1. From version 49, this feature is behind the gfx.offscreencanvas.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Document Tags and Contributors

 Contributors to this page: fscholz, nmve, teoli
 Last updated by: fscholz,