OffscreenCanvas: contextrestored Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Das contextrestored-Ereignis des OffscreenCanvas-Interfaces wird ausgelöst, wenn der Browser einen OffscreenCanvasRenderingContext2D-Kontext wiederherstellt, der zuvor verloren gegangen war.

Sie können nach Empfang dieses Ereignisses Ihre Ressourcen neu zeichnen, neu abrufen und den Zustand Ihres Kontexts erneut initialisieren.

Syntax

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

js
addEventListener("contextrestored", (event) => { })

oncontextrestored = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Der folgende Codeausschnitt erkennt das Kontextwiederherstellungsereignis.

js
const canvas = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("2d");

canvas.addEventListener(
  "contextrestored",
  (e) => {
    console.log(e);
    // call to redrawCanvas() or similar
  },
  false,
);

Spezifikationen

Specification
HTML
# event-contextrestored
HTML
# handler-offscreencanvas-oncontextrestored

Browser-Kompatibilität

Siehe auch