HTMLCanvasElement: webglcontextcreationerror 事件

基线 广泛可用

此功能已十分成熟，可以在许多设备和浏览器版本上使用。它已在浏览器中可用，自 2015 年 7 月.

如果用户代理无法创建 WebGLRenderingContext 上下文，则会触发 WebGL API 的 webglcontextcreationerror 事件。

此事件具有 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");
  },
  false,
);

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

规范

规范
WebGL 规范
# 5.15.4

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅