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 aufgrund von Treiberabstürzen, Speichermangel und ähnlichen Problemen passieren.
Wenn der User-Agent erkennt, dass der Canvas-Hintergrabspeicher verloren gegangen ist, löst er das contextlost
Ereignis beim zugehörigen HTMLCanvasElement
aus.
Wenn dieses Ereignis nicht abgebrochen wird, wird versucht, den Hintergrundspeicher in den Standardzustand zurückzusetzen (dies entspricht dem Aufruf von CanvasRenderingContext2D.reset()
).
Bei Erfolg wird das contextrestored
Ereignis ausgelöst, das anzeigt, dass der Kontext bereit ist, erneut initialisiert und neu gezeichnet zu werden.
Syntax
isContextLost()
Parameter
Keine.
Rückgabewert
true
, wenn der Rendering-Kontext verloren gegangen ist; andernfalls false
.
Beispiele
const ctx = canvas.getContext("2d");
if (ctx.isContextLost()) {
console.log("Context is lost");
}
Spezifikationen
Specification |
---|
HTML Standard # dom-context-2d-iscontextlost |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Das Interface, das diese Methode definiert:
CanvasRenderingContext2D
HTMLCanvasElement: contextlost
EreignisHTMLCanvasElement: contextrestored
Ereignis