HTMLCanvasElement: webglcontextlost Event
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 Benutzeragent erkennt, dass der Zeichenpuffer, der mit einem WebGLRenderingContext-Objekt verbunden ist, verloren gegangen ist.
Dieses Ereignis wird nicht weitergegeben.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("webglcontextlost", (event) => { })
onwebglcontextlost = (event) => { }
Ereignistyp
Ein WebGLContextEvent. Erbt von Event.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von ihrer Elternschnittstelle, Event.
WebGLContextEvent.statusMessage-
Eine schreibgeschützte Eigenschaft, die zusätzliche Informationen über das Ereignis enthält.
Beispiel
Mit Hilfe der WEBGL_lose_context-Erweiterung können Sie das webglcontextlost-Ereignis simulieren:
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 |