Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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

Spezifikation
HTML
# dom-context-2d-iscontextlost

Browser-Kompatibilität

Siehe auch