HTMLCanvasElement: событие contextlost

Событие contextlost API холста Canvas API срабатывает, если пользовательский агент определяет, что хранилище, связанное с контекстом CanvasRenderingContext2D, потеряно. Контексты могут быть потеряны по разным причинам, таким как сбои драйвера или недостаток памяти у приложения.

По умолчанию пользовательский агент попытается восстановить контекст и затем запустить событие contextrestored. Код пользователя может предотвратить восстановление контекста, вызвав Event.preventDefault() во время обработки события.

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

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

oncontextlost = (event) => {};

Общее событие Event.

Фрагмент кода ниже обнаруживает событие contextlost.

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

canvas.addEventListener("contextlost", (event) => {
  console.log(event);
});

Чтобы предотвратить восстановление контекста, код может выглядеть так:

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

canvas.addEventListener("contextlost", (event) => {
  event.preventDefault();
});

• HTMLCanvasElement: contextrestored событие
• CanvasRenderingContext2D.isContextLost()
• OffscreenCanvas: contextlost событие