JS властивість Event.fullscreenerror
Загальний опис
Подія fullscreenerror виникає, коли спроба увійти в повноекранний режим або вийти з нього завершилася невдачею через певну помилку. Ця подія є важливою для відслідковування помилок, які можуть виникнути при виклику методів requestFullscreen() або exitFullscreen(), що дозволяють елементам переходити в повноекранний режим або виходити з нього. У випадку виникнення помилки, fullscreenerror дає можливість програмістам реагувати на неї — наприклад, показувати повідомлення користувачам або виконувати іншу обробку помилок.
Помилки повноекранного режиму можуть виникати з різних причин: обмеження безпеки браузера, неможливість доступу до елементів через політику захисту контенту (CSP), або ж користувач відхилив запит на повноекранний режим. Щоб відстежувати такі помилки, до документа додається обробник події fullscreenerror.
Приклад використання:
document.addEventListener('fullscreenerror', function(event) {
console.error('Помилка при спробі увійти в повноекранний режим:', event);
});
У цьому прикладі, коли виникає помилка під час спроби увійти або вийти з повноекранного режиму, повідомлення про помилку виводиться у консоль разом з деталями події.
Подія fullscreenerror дозволяє програмістам обробляти ситуації, коли взаємодія з повноекранним режимом не відбувається належним чином. Це може бути особливо корисним у ситуаціях, де повноекранний режим є важливою частиною користувацького досвіду, наприклад, у відеоплеєрах або в інтерактивних веб-додатках. Керування подією дозволяє попередити користувача про проблему або автоматично відновити інший інтерфейс.
Зазвичай подія виникає після того, як викликаються методи requestFullscreen() або exitFullscreen(), якщо браузер не дозволяє виконати операцію або виникає інша помилка.
| Порада: | Якщо елемент не може увійти в повноекранний режим через політику безпеки або обмеження браузера, зручно повідомляти користувача про це. Виведіть відповідне повідомлення або спробуйте альтернативний підхід, наприклад, розширення елементу до розмірів вікна. |
| Порада: | Використовуйте подію |
| Порада: | Тестуйте роботу з повноекранним режимом у різних умовах, таких як мобільні пристрої або обмеження браузера. Це допоможе виявити можливі помилки, які можуть бути оброблені через |
Синтаксис
document.addEventListener('fullscreenerror', function(event) {
// Код, що виконується при виникненні помилки повноекранного режиму
});Значення
Return
Переглядачі
| Переглядач | |||||
|---|---|---|---|---|---|
66 |
57 |
11.1 |
53 |
16 |
| Переглядач | ||||
|---|---|---|---|---|
66 |
66 |
57 |
11.3 |
| Переглядач | ||
|---|---|---|
15.0.0 |
1.0 |
Приклади
У цьому прикладі, якщо виникає помилка при спробі увійти в повноекранний режим, користувачеві відображається повідомлення про неможливість виконання дії. Це корисно, щоб інформувати користувача про проблеми з доступом до повноекранного режиму.
document.addEventListener('fullscreenerror', function(event) {
alert('Неможливо увійти в повноекранний режим. Будь ласка, перевірте налаштування браузера.');
});
document.getElementById('startFullscreen').addEventListener('click', function() {
document.getElementById('content').requestFullscreen().catch(err => {
console.error('Запит на повноекранний режим не вдався:', err);
});
});У цьому прикладі, якщо при виході з повноекранного режиму виникає помилка, вона логуватиметься в консолі для подальшого аналізу. Це корисно для виявлення проблем із завершенням повноекранного режиму, зокрема у складних мультимедійних або інтерактивних додатках.
document.addEventListener('fullscreenerror', function(event) {
console.error('Помилка повноекранного режиму:', event);
});
document.getElementById('exitFullscreen').addEventListener('click', function() {
if (document.fullscreenElement) {
document.exitFullscreen().catch(err => {
console.error('Помилка при виході з повноекранного режиму:', err);
});
}
});