CanvasRenderingContext2D:isContextLost() 方法

有限可用性

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

Canvas 2D API 的CanvasRenderingContext2D.isContextLost()方法在渲染上下文丢失(并且尚未重置)时返回true。这可能是由于驱动程序崩溃、内存不足等原因导致的。

如果用户代理检测到画布后备存储已丢失,它将在关联的HTMLCanvasElement上触发contextlost事件。如果未取消此事件,它将尝试将后备存储重置为默认状态(这相当于调用CanvasRenderingContext2D.reset())。成功后,它将触发contextrestored事件,指示上下文已准备好重新初始化和重绘。

语法

js
isContextLost()

参数

无。

返回值

如果渲染上下文已丢失,则返回true;否则返回false

示例

js
const ctx = canvas.getContext("2d");

if (ctx.isContextLost()) {
  console.log("Context is lost");
}

规范

规范
HTML 标准
# dom-context-2d-iscontextlost

浏览器兼容性

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

另请参阅