CanvasRenderingContext2D: isContextLost() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
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("コンテキストが失われています");
}
仕様書
| 仕様書 |
|---|
| HTML # dom-context-2d-iscontextlost |
ブラウザーの互換性
関連情報
- このメソッドを定義しているインターフェイス:
CanvasRenderingContext2D HTMLCanvasElement: contextlosteventHTMLCanvasElement: contextrestoredevent