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 Benutzeragent nicht in der Lage ist, einen WebGLRenderingContext Kontext zu erstellen.
Dieses Ereignis verfügt über eine WebGLContextEvent.statusMessage Eigenschaft, die einen plattformabhängigen String enthalten kann, der weitere Informationen über das Scheitern bietet.
Dieses Ereignis wird nicht gebubbelt.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandler-Eigenschaft.
js
addEventListener("webglcontextcreationerror", (event) => { })
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 |