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 Standard
# dom-context-2d-iscontextlost

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch