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

瀏覽器相容性

另見