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 nicht in der Lage ist, einen WebGLRenderingContext-Kontext zu erstellen.
Dieses Ereignis besitzt eine WebGLContextEvent.statusMessage-Eigenschaft, die eine plattformabhängige Zeichenkette mit weiteren Informationen über den Fehler enthalten kann.
Dieses Ereignis wird nicht propagiert.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("webglcontextcreationerror", (event) => { })
onwebglcontextcreationerror = (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
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 |