HTMLCanvasElement: webglcontextcreationerror Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

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 einen plattformspezifischen String mit weiteren Informationen über den Fehler enthalten kann.

Dieses Ereignis blubbert nicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignisbehandlungs-Eigenschaft.

addEventListener("webglcontextcreationerror", (event) => { })

onwebglcontextcreationerror = (event) => { }

Ereignistyp

Ein WebGLContextEvent. Erbt von Event.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von ihrer übergeordneten Schnittstelle, 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");
  },
  false,
);

const gl = canvas.getContext("webgl");
// logs statusMessage or "Unknown error" if unable to create WebGL context

Spezifikationen

Specification
WebGL Specification # 5.15.4