HTMLCanvasElement: contextlost-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Das contextlost-Ereignis der Canvas API wird ausgelöst, wenn der User-Agent feststellt, dass der zugehörige Speicher eines CanvasRenderingContext2D-Kontexts verloren gegangen ist.
Kontexte können aus verschiedenen Gründen verloren gehen, wie zum Beispiel Treiberabstürze oder Speichermangel der Anwendung.
Standardmäßig wird der User-Agent versuchen, den Kontext wiederherzustellen und anschließend das contextrestored-Ereignis auslösen.
Benutzercode 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 Ereignishandler-Eigenschaft.
addEventListener("contextlost", (event) => { })
oncontextlost = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiel
Der folgende Codeausschnitt 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
| Spezifikation |
|---|
| HTML # event-contextlost |