CanvasRenderingContext2D: isContextLost() メソッド
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
CanvasRenderingContext2D.isContextLost() はキャンバス 2D API のメソッドで、この描画コンテキストが失われている場合（そしてリセットされていない場合）に true を返します。
これは、ドライバーのクラッシュやメモリー不足などによって発生することがあります。
ユーザーエージェントがキャンバスのバッキングストレージが失われたことを検出した場合、 contextlost イベント を関連付けられた HTMLCanvasElement に対して発生させます。
このイベントがキャンセルされなかった場合、バッキングストレージをデフォルト状態にリセットしようと試みます（これは CanvasRenderingContext2D.reset() を呼び出すことに相当します）。
成功すると、contextrestored イベント が発生し、コンテキストが再初期化および再描画の準備が整ったことを示します。
構文
js
isContextLost()
引数
なし。
返値
描画コンテキストが失われている場合は true です。そうでなければ false です。
例
js
const ctx = canvas.getContext("2d");
if (ctx.isContextLost()) {
console.log("コンテキストが失われています");
}
仕様書
| Specification |
|---|
| HTML # dom-context-2d-iscontextlost |
ブラウザーの互換性
関連情報
- このメソッドを定義しているインターフェイス:
CanvasRenderingContext2D HTMLCanvasElement: contextlosteventHTMLCanvasElement: contextrestoredevent