Canvas 2D API 的 CanvasRenderingContext2D.isContextLost() 方法用于检查渲染上下文是否丢失(且尚未重置)。这可能由于驱动程序崩溃、内存耗尽等原因发生。
如果用户代理检测到画布后备存储丢失,它会在相关的 HTMLCanvasElement 上触发 contextlost 事件。如果这个事件没有被取消,用户代理将尝试将后备存储重置为默认状态(相当于调用 CanvasRenderingContext2D.reset())。成功后,它会触发 contextrestored 事件,表示上下文已准备好重新初始化和重绘。
语法
isContextLost()
参数
无。
返回值
如果渲染上下文已丢失,则返回 true;否则返回 false。
示例
const ctx = canvas.getContext("2d");
if (ctx.isContextLost()) {
console.log("上下文已丢失");
}
规范
浏览器兼容性
参见
- 定义此方法的接口:CanvasRenderingContext2D
HTMLCanvasElement: contextlost事件HTMLCanvasElement: contextrestored事件
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
