CanvasRenderingContext2D: isContextLost() 方法

可用性有限

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

CanvasRenderingContext2D.isContextLost() 方法属于 Canvas 2D API，用于在渲染上下文丢失（且尚未重置）时返回 true。这种情况可能由于驱动程序崩溃、内存不足等原因而发生。

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

语法

isContextLost()

无。

如果渲染上下文已丢失，则返回 true；否则返回 false。

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

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

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

此页面最后由 MDN 贡献者于 2025 年 9 月 25 日修改。