CanvasRenderingContext2D: isContextLost()-Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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
| Spezifikation |
|---|
| HTML # dom-context-2d-iscontextlost |
Browser-Kompatibilität
Siehe auch
- Die Schnittstelle, die diese Methode definiert:
CanvasRenderingContext2D HTMLCanvasElement: contextlost-EreignisHTMLCanvasElement: contextrestored-Ereignis