HTMLCanvasElement: webglcontextcreationerror-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.
Das webglcontextcreationerror-Ereignis der WebGL-API wird ausgelöst, wenn der User Agent keinen WebGLRenderingContext-Kontext erstellen kann.
Dieses Ereignis besitzt eine WebGLContextEvent.statusMessage-Eigenschaft, die eine plattformabhängige Zeichenfolge mit weiteren Informationen zum Fehler enthalten kann.
Dieses Ereignis wird nicht weitergereicht (Bubbling).
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
js
addEventListener("webglcontextcreationerror", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
js
onwebglcontextcreationerror = (event) => { }
Ereignistyp
Ein WebGLContextEvent. Erbt von Event.
Beispiel
js
const canvas = document.getElementById("canvas");
canvas.addEventListener("webglcontextcreationerror", (e) => {
console.log(e.statusMessage || "Unknown error");
});
const gl = canvas.getContext("webgl");
// logs statusMessage or "Unknown error" if unable to create WebGL context
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.15.4 |