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 aufgrund von Treiberabstürzen, Speichermangel und Ähnlichem auftreten.
Wenn der Benutzeragent feststellt, dass der Canvas-Speicher verloren gegangen ist, wird das contextlost-Ereignis beim zugehörigen HTMLCanvasElement ausgelöst.
Wenn dieses Ereignis nicht abgebrochen wird, versucht es, den Speicherspeicher 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, neu 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
| Spezifikation |
|---|
| HTML # dom-context-2d-iscontextlost |
Browser-Kompatibilität
Siehe auch
- Die Schnittstelle, die diese Methode definiert:
CanvasRenderingContext2D HTMLCanvasElement: contextlost-EreignisHTMLCanvasElement: contextrestored-Ereignis