HTMLCanvasElement: webglcontextcreationerror 事件
webglcontextcreationerror 事件是 WebGL API 的一部分,当用户代理无法创建 WebGLRenderingContext 上下文时会触发此事件。
此事件有一个 WebGLContextEvent.statusMessage 属性,其中可能包含一个依赖于平台的字符串,提供有关失败的更多信息。
此事件不冒泡。
语法
在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。
js
addEventListener("webglcontextcreationerror", (event) => { })
onwebglcontextcreationerror = (event) => { }
事件类型
一个 WebGLContextEvent。继承自 Event。
事件属性
此接口继承自其父接口 Event 的属性。
WebGLContextEvent.statusMessage-
一个只读属性,包含有关事件的附加信息。
示例
js
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
规范
| 规范 |
|---|
| WebGL 规范 # 5.15.4 |
浏览器兼容性
加载中…