Back to Content

OffscreenCanvas: contextrestored event

files/en-us/web/api/offscreencanvas/contextrestored_event/index.md

latest1.4 KB
Original Source

{{APIRef("Canvas API")}}

The contextrestored event of the {{domxref("OffscreenCanvas")}} interface is fired if the browser restores an OffscreenCanvasRenderingContext2D context that was previously lost.

You can redraw, re-retrieve resources, and reinitialize the state of your context after receiving this event.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

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

oncontextrestored = (event) => { }

Event type

A generic {{domxref("Event")}}.

Examples

The code fragment below detects the context restored event.

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

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also