JS властивість Event.fullscreenerror

Загальний опис

Подія fullscreenerror виникає, коли спроба увійти в повноекранний режим або вийти з нього завершилася невдачею через певну помилку. Ця подія є важливою для відслідковування помилок, які можуть виникнути при виклику методів requestFullscreen() або exitFullscreen(), що дозволяють елементам переходити в повноекранний режим або виходити з нього. У випадку виникнення помилки, fullscreenerror дає можливість програмістам реагувати на неї — наприклад, показувати повідомлення користувачам або виконувати іншу обробку помилок.

Помилки повноекранного режиму можуть виникати з різних причин: обмеження безпеки браузера, неможливість доступу до елементів через політику захисту контенту (CSP), або ж користувач відхилив запит на повноекранний режим. Щоб відстежувати такі помилки, до документа додається обробник події fullscreenerror.

Приклад використання:

document.addEventListener('fullscreenerror', function(event) {
  console.error('Помилка при спробі увійти в повноекранний режим:', event);
});

У цьому прикладі, коли виникає помилка під час спроби увійти або вийти з повноекранного режиму, повідомлення про помилку виводиться у консоль разом з деталями події.

Подія fullscreenerror дозволяє програмістам обробляти ситуації, коли взаємодія з повноекранним режимом не відбувається належним чином. Це може бути особливо корисним у ситуаціях, де повноекранний режим є важливою частиною користувацького досвіду, наприклад, у відеоплеєрах або в інтерактивних веб-додатках. Керування подією дозволяє попередити користувача про проблему або автоматично відновити інший інтерфейс.

Зазвичай подія виникає після того, як викликаються методи requestFullscreen() або exitFullscreen(), якщо браузер не дозволяє виконати операцію або виникає інша помилка.

правити

Порада

Якщо елемент не може увійти в повноекранний режим через політику безпеки або обмеження браузера, зручно повідомляти користувача про це. Виведіть відповідне повідомлення або спробуйте альтернативний підхід, наприклад, розширення елементу до розмірів вікна.

автор: Bond правити

Порада

Використовуйте подію fullscreenerror для відстеження специфічних проблем у складних інтерфейсах, які залежать від повноекранного режиму. Наприклад, при відсутності доступу до повноекранного режиму можна відключити непотрібні кнопки або елементи.

автор: Bond правити

Порада

Тестуйте роботу з повноекранним режимом у різних умовах, таких як мобільні пристрої або обмеження браузера. Це допоможе виявити можливі помилки, які можуть бути оброблені через fullscreenerror.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

document.addEventListener('fullscreenerror', function(event) {
  // Код, що виконується при виникненні помилки повноекранного режиму
});

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	66	57	11.1	53	16

Підтримка: мобільні переглядачі

Переглядач
	66	66	57	11.3

Підтримка: серверні переглядачі

Переглядач
	15.0.0	1.0

Приклади

+ запропонувати свій приклад у пісочниці

<button id="startFullscreen">Старт</button>
<div id="content">Демонстраційний елемент</div>

document.addEventListener('fullscreenerror', function(event) {
  alert('Неможливо увійти в повноекранний режим. Будь ласка, перевірте налаштування браузера.');
});
document.getElementById('startFullscreen').addEventListener('click', function() {
  document.getElementById('content').requestFullscreen().catch(err => {
    console.error('Запит на повноекранний режим не вдався:', err);
  });
});

<button id="exitFullscreen">На весь екран</button>

document.addEventListener('fullscreenerror', function(event) {
  console.error('Помилка повноекранного режиму:', event);
});
document.getElementById('exitFullscreen').addEventListener('click', function() {
  if (document.fullscreenElement) {
    document.exitFullscreen().catch(err => {
      console.error('Помилка при виході з повноекранного режиму:', err);
    });
  }
});