CanvasRenderingContext2D: isContextLost()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die CanvasRenderingContext2D.isContextLost()-Methode der Canvas 2D API gibt true zurück, wenn der Rendering-Kontext verloren gegangen ist (und noch nicht zurückgesetzt wurde).
Dies kann durch Treiberabstürze, Speicherüberlauf und so weiter passieren.
Wenn der User-Agent feststellt, dass der Canvas-Speicher verloren gegangen ist, löst er das contextlost-Ereignis beim zugehörigen HTMLCanvasElement aus.
Wenn dieses Ereignis nicht abgebrochen wird, versucht es, den Speicher in den Standardzustand zurückzusetzen (dies entspricht dem Aufruf von CanvasRenderingContext2D.reset()).
Bei Erfolg wird das contextrestored-Ereignis ausgelöst, was anzeigt, dass der Kontext bereit ist, neu initialisiert und neu gezeichnet zu werden.
Syntax
isContextLost()
Parameter
Keine.
Rückgabewert
true, wenn der Rendering-Kontext verloren gegangen ist; false sonst.
Beispiele
const ctx = canvas.getContext("2d");
if (ctx.isContextLost()) {
console.log("Context is lost");
}
Spezifikationen
| Specification |
|---|
| HTML # dom-context-2d-iscontextlost |
Browser-Kompatibilität
Loading…
Siehe auch
- Die Schnittstelle, die diese Methode definiert:
CanvasRenderingContext2D HTMLCanvasElement: contextlost-EreignisHTMLCanvasElement: contextrestored-Ereignis