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

1. This feature is experimentally implemented since Firefox 49; to activate it, in about:config, set gfx.offscreencanvas.enabled to true

See also

• WebGLRenderingContext.isContextLost()
• WEBGL_lose_context, WEBGL_lose_context.loseContext(), WEBGL_lose_context.restoreContext()
• Events: webglcontextlost, webglcontextrestored, webglcontextcreationerror