HTMLCanvasElement: webglcontextrestored 事件

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

webglcontextrestoredWebGL API 中的一个事件,当用户代理为 WebGLRenderingContext 对象恢复绘图缓冲区时,会触发此事件。

上下文恢复后,之前创建的 WebGL 资源(如纹理和缓冲区)将不再有效。您需要重新初始化 WebGL 应用程序的状态并重新创建资源。

此事件不冒泡。

语法

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

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

onwebglcontextrestored = (event) => { }

事件类型

一个 WebGLContextEvent。继承自 Event

Event WebGLContextEvent

事件属性

此接口继承自其父接口 Event 的属性。

WebGLContextEvent.statusMessage

一个只读属性,包含有关事件的附加信息。

示例

借助 WEBGL_lose_context 扩展,您可以模拟 webglcontextrestored 事件。

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");

canvas.addEventListener("webglcontextrestored", (e) => {
  console.log(e);
});

gl.getExtension("WEBGL_lose_context").restoreContext();

// "webglcontextrestored" event is logged.

规范

规范
WebGL 规范
# 5.15.3

浏览器兼容性

另见