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 日修改。