HTMLCanvasElement: webglcontextcreationerror event

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⁩.

Thewebglcontextcreationerror event of theWebGL API is fired if the user agent is unable to create aWebGLRenderingContext context.

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

This event does not bubble.

Syntax

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

addEventListener("webglcontextcreationerror", (event) => { })onwebglcontextcreationerror = (event) => { }

Event type

AWebGLContextEvent. Inherits fromEvent.

Event properties

This interface inherits properties from its parent interface,Event.

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

Example

const canvas = document.getElementById("canvas");canvas.addEventListener("webglcontextcreationerror", (e) => {  console.log(e.statusMessage || "Unknown error");});const gl = canvas.getContext("webgl");// logs statusMessage or "Unknown error" if unable to create WebGL context