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 Zeichenoperationen erneut ausführen, Ressourcen erneut abrufen und den Zustand Ihres Kontextes neu initialisieren.

Syntax

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

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

oncontextrestored = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

Das folgende Codefragment erkennt das Kontext-wiederhergestellt-Ereignis.

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 Standard
# event-contextrestored
HTML Standard
# handler-offscreencanvas-oncontextrestored

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch