HTMLCanvasElement: contextlost-Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Das contextlost-Ereignis der Canvas API wird ausgelöst, wenn der Benutzeragent erkennt, dass der zugehörige Speicher eines CanvasRenderingContext2D-Kontextes verloren ist. Kontexte können aus mehreren Gründen verloren gehen, wie z.B. Treiberabstürze oder die Anwendung läuft aus dem Speicher, usw.

Standardmäßig versucht der Benutzeragent, den Kontext wiederherzustellen und löst dann das contextrestored-Ereignis aus. Benutzerdefinierter Code kann verhindern, dass der Kontext wiederhergestellt wird, indem Event.preventDefault() während der Ereignisbehandlung aufgerufen wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("contextlost", (event) => { })

oncontextlost = (event) => { }

Ereignistyp

Ein generischer Event.

Beispiel

Das folgende Codefragment erkennt das contextlost-Ereignis.

const canvas = document.getElementById("canvas");

canvas.addEventListener("contextlost", (event) => {
  console.log(event);
});

Um zu verhindern, dass der Kontext wiederhergestellt wird, könnte der Code stattdessen so aussehen:

const canvas = document.getElementById("canvas");

canvas.addEventListener("contextlost", (event) => {
  event.preventDefault();
});

Spezifikationen

Specification
HTML # event-contextlost