OffscreenCanvas: contextlost 事件
OffscreenCanvas 接口的 contextlost 事件,会在浏览器检测到 OffscreenCanvasRenderingContext2D 上下文丢失时触发。上下文丢失的原因有多种,例如关联的 GPU 驱动程序崩溃,或应用程序内存不足等。
默认情况下,用户代理会尝试恢复上下文,然后触发 contextrestored 事件。用户代码可以通过在事件处理过程中调用 Event.preventDefault() 来阻止上下文恢复。
语法
在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。
js
addEventListener("contextlost", (event) => { })
oncontextlost = (event) => { }
事件类型
一个通用的 Event。
示例
下面的代码片段检测 contextlost 事件。
js
const canvas = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("2d");
// Do drawing etc
canvas.addEventListener("contextlost", (event) => {
console.log(event);
});
要阻止上下文恢复,事件处理程序代码可能看起来像这样
js
canvas.addEventListener("contextlost", (event) => {
event.preventDefault();
});
规范
| 规范 |
|---|
| HTML # event-contextlost |
| HTML # handler-offscreencanvas-oncontextlost |
浏览器兼容性
加载中…