WEBGL_lose_context: Methode restoreContext()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.

Die Methode WEBGL_lose_context.restoreContext() ist Teil der WebGL-API und ermöglicht es Ihnen, das Wiederherstellen des Kontextes eines WebGLRenderingContext-Objekts zu simulieren.

Browser melden WebGL-Fehler möglicherweise standardmäßig nicht. Die Fehlerberichterstattung von WebGL funktioniert, indem getError() aufgerufen und auf Fehler überprüft wird. Folgende Ausnahmen können ausgelöst werden:

INVALID_OPERATION: Wird ausgelöst, wenn der Kontext nicht verloren gegangen ist.

Beispiele

Mit dieser Methode können Sie das webglcontextrestored Ereignis simulieren:

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

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

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