HTMLCanvasElement: webglcontextcreationerror event

The webglcontextcreationerror event of the WebGL API is fired if the user agent is unable to create a WebGLRenderingContext context.

This event has a WebGLContextEvent.statusMessage property, which can contain a platform dependent string with more information about the failure.

This event does not bubble.


Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener('webglcontextcreationerror', (event) => {});

onwebglcontextcreationerror = (event) => { };

Event type

Event properties

This interface inherits properties from its parent interface, Event.


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


const canvas = document.getElementById('canvas');

canvas.addEventListener('webglcontextcreationerror', (e) => {
  console.log(e.statusMessage || 'Unknown error');
}, false);

const gl = canvas.getContext('webgl');
// logs statusMessage or "Unknown error" if unable to create WebGL context


WebGL Specification
# 5.15.4

Browser compatibility

BCD tables only load in the browser

See also