HTMLCanvasElement: webglcontextcreationerror イベント

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年9月以降、すべてのブラウザーで利用可能です。

webglcontextcreationerror は WebGL API のイベントで、ユーザーエージェントが WebGLRenderingContext コンテキストを作成することができない場合に発行されます。

このイベントには WebGLContextEvent.statusMessage プロパティがあり、失敗に関する詳細情報を含むプラットフォーム依存の文字列を格納されることがあります。

このイベントはバブリングしません。

構文

このイベント名を addEventListener() などのメソッドで使用したり、イベントハンドラープロパティを設定したりしてください。

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

onwebglcontextcreationerror = (event) => {};

イベント型

WebGLContextEvent です。Event を継承しています。

イベントプロパティ

このインターフェイスには親インターフェイスである Event から継承したプロパティもあります。

WebGLContextEvent.statusMessage: 読み取り専用のプロパティで、イベントに関する追加情報を保持します。

例

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