HTMLCanvasElement: webglcontextrestored-Ereignis

Baseline Widely available

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

Das webglcontextrestored-Ereignis der WebGL API wird ausgelöst, wenn der User-Agent den Zeichenpuffer für ein WebGLRenderingContext-Objekt wiederherstellt.

Sobald der Kontext wiederhergestellt ist, sind WebGL-Ressourcen wie Texturen und Puffer, die vor dem Verlust des Kontexts erstellt wurden, nicht mehr gültig. Sie müssen den Zustand Ihrer WebGL-Anwendung neu initialisieren und Ressourcen neu erstellen.

Dieses Ereignis blubbert nicht.

Syntax

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

js
addEventListener("webglcontextrestored", (event) => {});

onwebglcontextrestored = (event) => {};

Ereignistyp

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

Mit Hilfe der WEBGL_lose_context Erweiterung können Sie das webglcontextrestored-Ereignis simulieren:

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");

canvas.addEventListener(
  "webglcontextrestored",
  (e) => {
    console.log(e);
  },
  false,
);

gl.getExtension("WEBGL_lose_context").restoreContext();

// "webglcontextrestored" event is logged.

Spezifikationen

Specification
WebGL Specification
# 5.15.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch