docs.rodeo

MDN Web Docs mirror

HTMLCanvasElement: contextrestored event

{{APIRef}} 

The contextrestored event of the Canvas API is fired if the user agent restores the backing storage for a CanvasRenderingContext2D.

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.

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

oncontextrestored = (event) => {};

Event type

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

Example

The code fragment below detects the context restored event.

const canvas = document.getElementById("canvas");

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

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

In this article

View on MDN