W3cubDocs

/Web APIs

HTMLCanvasElement: contextrestored event

Limited availability

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

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 addEventListener(), or set an event handler property.

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

oncontextrestored = (event) => { }

Event type

A generic 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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
contextrestored_event 99 99 125 85 No 99 125 68 No 18.0 99 No

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/contextrestored_event