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

js
isContextLost()

Parameter

Keine.

Rückgabewert

true, wenn der Rendering-Kontext verloren gegangen ist; andernfalls false.

Beispiele

js
const ctx = canvas.getContext("2d");

if (ctx.isContextLost()) {
  console.log("Context is lost");
}

Spezifikationen

Specification
HTML
# dom-context-2d-iscontextlost

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
isContextLost

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch