Spec-Zone.ru › Web APIs

OffscreenCanvas: событие contextlost

Ограниченная доступность

Эта функция не является базовой, так как она не работает во всех широко используемых браузерах.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Событие contextlost интерфейса OffscreenCanvas срабатывает, если браузер обнаруживает потерю контекста OffscreenCanvasRenderingContext2D. Контекст может быть потерян по нескольким причинам, например, из-за сбоя драйвера графического процессора или недостатка памяти в приложении.

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

Синтаксис

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

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

oncontextlost = (event) => {};

Тип события

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

Примеры

Фрагмент кода ниже определяет событие contextlost.

const canvas = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("2d");

// Do drawing etc

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

Для предотвращения восстановления контекста обработчик событий может выглядеть так:

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

Спецификации

Спецификация
HTML
# event-contextlost
HTML
# handler-offscreencanvas-oncontextlost

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
contextlost_event 99 99 125 85 Нет 99 125 68 Нет 18.0 99

См. также

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API