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 # dom-context-2d-iscontextlost |
Browser-Kompatibilität
Loading…
Siehe auch
- Das Interface, das diese Methode definiert:
CanvasRenderingContext2D HTMLCanvasElement: contextlostEreignisHTMLCanvasElement: contextrestoredEreignis