CanvasRenderingContext2D: Methode isContextLost()
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 Methode CanvasRenderingContext2D.isContextLost() der Canvas-2D-API gibt true zurück, wenn der Rendering-Kontext verloren gegangen ist (und noch nicht zurückgesetzt wurde).
Dies kann beispielsweise durch einen Treiberabsturz oder Speichermangel geschehen.
Wenn der User Agent erkennt, dass der Hintergrundspeicher des Canvas verloren gegangen ist, löst er das contextlost-Ereignis am zugehörigen HTMLCanvasElement aus.
Wird dieses Ereignis nicht abgebrochen, versucht er, den Hintergrundspeicher auf den Standardzustand zurückzusetzen (dies entspricht einem Aufruf von CanvasRenderingContext2D.reset()).
Bei Erfolg löst er das contextrestored-Ereignis aus. Dies zeigt an, dass der Kontext erneut initialisiert und der Inhalt neu gezeichnet werden kann.
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