HTMLCanvasElement：contextlost 事件

有限可用性

此功能不是基线，因为它在一些最广泛使用的浏览器中不起作用。

contextlost 事件是 Canvas API 的一部分，如果用户代理检测到与 CanvasRenderingContext2D 上下文关联的后备存储已丢失，则会触发该事件。上下文可能由于多种原因而丢失，例如驱动程序崩溃或应用程序内存不足等。

默认情况下，用户代理将尝试恢复上下文，然后触发 contextrestored 事件。用户代码可以通过在事件处理期间调用 Event.preventDefault() 来阻止上下文恢复。

语法

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

js
addEventListener("contextlost", (event) => {});

oncontextlost = (event) => {};

事件类型

一个通用的 Event。

示例

下面的代码片段检测 contextlost 事件。

js
const canvas = document.getElementById("canvas");

canvas.addEventListener("contextlost", (event) => {
  console.log(event);
});

为了防止上下文恢复，代码可能如下所示

js
const canvas = document.getElementById("canvas");

canvas.addEventListener("contextlost", (event) => {
  event.preventDefault();
});

规范

规范
HTML 标准
# event-contextlost

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅