HTMLCanvasElement: webglcontextlost-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Das webglcontextlost-Ereignis der WebGL API wird ausgelöst, wenn der User Agent erkennt, dass der einem WebGLRenderingContext-Objekt zugeordnete Zeichenpuffer verloren gegangen ist.
Dieses Ereignis wird nicht weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
js
addEventListener("webglcontextlost", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
js
onwebglcontextlost = (event) => { }
Ereignistyp
Ein WebGLContextEvent. Erbt von Event.
Beispiel
Mithilfe der Erweiterung WEBGL_lose_context können Sie das webglcontextlost-Ereignis simulieren:
js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
canvas.addEventListener("webglcontextlost", (event) => {
console.log(event);
});
gl.getExtension("WEBGL_lose_context").loseContext();
// "webglcontextlost" event is logged.
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.15.2 |