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 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
| Specification |
|---|
| HTML # event-contextlost |
Browser-Kompatibilität
Loading…