CKTIS / HTML
oncontextlost: gestionar la pérdida del contexto de canvas
El atributo oncontextlost especifica el código que gestiona el evento contextlost, que se envía cuando se pierde el contexto de renderizado 2D de un elemento canvas. Permite que una aplicación reaccione a la pérdida de recursos, pero no restaura el dibujo por sí mismo.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;oncontextlost es un atributo global de gestión del evento contextlost. En la práctica, se usa en un elemento canvas cuyo contexto 2D ha perdido el almacenamiento que contiene la imagen. El valor del atributo es código JavaScript, no un valor booleano; el código recibe el objeto event.
En JavaScript, puedes asignar una función a la propiedad canvas.oncontextlost. Como alternativa, usa canvas.addEventListener('contextlost', handler). OffscreenCanvas también expone una propiedad oncontextlost, pero no es un elemento HTML y no tiene atributos de marcado. No confundas este evento con el evento WebGL webglcontextlost.
Cuando se pierde realmente el contexto, el navegador restablece el estado de renderizado. El evento contextlost se puede cancelar: event.preventDefault() detiene el intento de restauración del contexto descrito por el estándar; no llames a este método si quieres permitir ese intento. La restauración no está garantizada. Después de contextrestored, la aplicación debe volver a aplicar el estado necesario y redibujar su contenido.
El ejemplo envía un evento sintético, por lo que funciona sin provocar un fallo gráfico. La salida contextlost: false muestra el tipo de evento y el valor de event.isTrusted. Esta prueba comprueba únicamente la gestión del evento, no la pérdida de recursos ni su restauración.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>oncontextlost test</title>
<canvas id="surface" oncontextlost="document.getElementById('result').textContent = event.type + ': ' + event.isTrusted"></canvas>
<pre id="result">waiting</pre>
<script>
document.getElementById('surface').dispatchEvent(
new Event('contextlost', { cancelable: true })
);
</script>Resultado
contextlost: 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.