W3cubDocs

/Web APIs

WebGLContextEvent

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨September 2016⁩.

* Some parts of this feature may have varying levels of support.

Note: This feature is available in Web Workers.

The WebGLContextEvent 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.

Constructor

WebGLContextEvent(): Creates a new WebGLContextEvent object.

Instance properties

This interface inherits properties from its parent interface, Event.

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

Instance 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:

const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");

canvas.addEventListener(
  "webglcontextlost",
  (e) => {
    console.log(e);
  },
  false,
);

gl.getExtension("WEBGL_lose_context").loseContext();

// WebGLContextEvent event with type "webglcontextlost" is logged.

Specifications

Specification
WebGL Specification> # 5.15>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`WebGLContextEvent`	17	12	49	15	6	25	49	14	8	1.5	4.4	8
`WebGLContextEvent`	9	12	49	12	5.1	25	49	12	8	1.5	4.4	8
`statusMessage`	9	12	49	12	5.1	25	49	12	8	1.5	4.4	8
`worker_support`	No	No	105	No	No	No	105	No	No	No	No	No