Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

oncontextrestored: gestionar la restauración del contexto de canvas

El atributo oncontextrestored especifica el código que gestiona el evento contextrestored. En un canvas con contexto 2D, el evento indica que el contexto se ha restaurado después de perderse; entonces la aplicación debería reconstruir la configuración de dibujo y el contenido.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);

oncontextrestored es un atributo HTML para gestionar eventos y una propiedad JavaScript correspondiente de GlobalEventHandlers. El nombre del evento es contextrestored, sin el prefijo on. En HTML, el valor del atributo es código JavaScript que tiene disponible el parámetro event; a la propiedad JavaScript se le asigna una función o null. addEventListener("contextrestored", handler) es una alternativa que permite registrar varios escuchadores.

El navegador envía este evento al canvas después de restaurar correctamente un contexto 2D que se había perdido. La pérdida del contexto restablece el estado de dibujo, por lo que el controlador debería volver a aplicar los estilos y las transformaciones necesarios y dibujar de nuevo la escena a partir de los datos de la aplicación. No des por sentado que los píxeles anteriores se recuperan automáticamente. Asignar un controlador no restaura el contexto ni garantiza que la restauración se complete.

El ejemplo solo comprueba la conexión del atributo al enviar un evento sintético. El valor de event.isTrusted es false; esto no prueba una pérdida real del contexto ni su recuperación. Ejecútalo en un navegador que admita la propiedad y permita los scripts inline.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>oncontextrestored test</title>
<canvas id="surface" width="80" height="40"
  oncontextrestored="console.log(event.type, event.isTrusted)"></canvas>
<script>
  const canvas = document.getElementById("surface");
  if (!("oncontextrestored" in canvas)) {
    throw new Error("oncontextrestored is not supported");
  }
  canvas.dispatchEvent(new Event("contextrestored"));
</script>

Resultado

contextrestored false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes