HTMLCanvasElement: webglcontextcreationerror 事件

Baseline 已广泛支持

此特性已非常成熟,可在多种设备和浏览器版本上使用。自 ⁨2016 年 9 月⁩以来,它已在各大浏览器中可用。

webglcontextcreationerror 事件是 WebGL API 的一部分,当用户代理无法创建 WebGLRenderingContext 上下文时会触发此事件。

此事件有一个 WebGLContextEvent.statusMessage 属性,其中可能包含一个依赖于平台的字符串,提供有关失败的更多信息。

此事件不冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

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

onwebglcontextcreationerror = (event) => { }

事件类型

一个 WebGLContextEvent。继承自 Event

Event WebGLContextEvent

事件属性

此接口继承自其父接口 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

浏览器兼容性

另见