API разрешений

API разрешений предоставляет согласованный программно-ориентированный способ запроса статуса разрешений API, присвоенных текущему контексту, например, веб-странице или потоку. Например, его можно использовать для определения того, было ли разрешение на доступ к определенной функции или API предоставлено, отклонено или требует специального разрешения пользователя.

Исторически разные API обрабатывают свои разрешения несовместимым образом — например, API уведомлений предоставлял собственные методы для запроса разрешений и проверки статуса разрешений, в то время как API геолокации этого не делал. API разрешений предоставляет инструменты для разработчиков, чтобы реализовать согласованный пользовательский опыт работы с разрешениями.

Разрешения из этого API эффективно агрегируют все ограничения безопасности для контекста, включая любое требование к API для использования в защищенном контексте, ограничения Permissions-Policy, примененные к документу, требования к взаимодействию с пользователем и запросы у пользователя. Таким образом, например, если API ограничен политикой разрешений, возвращаемое разрешение будет denied и пользователь не будет приглашен для предоставления доступа.

Свойство permissions стало доступно в объекте Navigator, как в стандартном контексте браузера, так и в контексте потока (WorkerNavigator — поэтому проверка разрешений доступна внутри потоков), и возвращает объект Permissions, который предоставляет доступ к функциональности API разрешений.

После получения этого объекта вы можете использовать метод Permissions.query(), чтобы вернуть промис, который разрешается со статусом PermissionStatus для определенного API.

Если статус разрешения prompt, пользователь должен подтвердить запрос, чтобы предоставить доступ к функции.

Механизм, который запускает этот запрос, будет зависеть от конкретного API — он не определен как часть API разрешений. Обычно триггером является код, вызывающий метод для доступа или открытия функции, или код, регистрирующий обработчик уведомлений от функции, которая затем будет к ней обращаться.

Обратите внимание, что не все функции требуют запроса. Разрешение может быть предоставлено Permission Policy, неявно путем временного включения или с помощью какого-либо другого механизма.

Отмена разрешения не управляется API. Более конкретно, метод Permissions.revoke() был предложен, но с тех пор был удален из тех браузеров, где он был реализован.

Пользователи могут вручную отменить разрешение для определенных сайтов, используя настройки браузера:

• Firefox: Меню > Настройки > Конфиденциальность и безопасность > Разрешения (затем выберите кнопку Настройки для интересующего разрешения).
• Chrome: Меню > Настройки > Дополнительные настройки. В разделе Конфиденциальность нажмите Настройки контента. В открывшемся диалоговом окне найдите раздел Местоположение и выберите Спрашивать, когда сайт пытается…. Наконец, нажмите Управление исключениями и удалите разрешения, предоставленные сайтам, которые вас интересуют.

Не все статусы разрешений API могут быть запрошены с помощью API разрешений. Неполный список API, учитывающих разрешения, включает:

• API фоновой синхронизации: background-sync (должно быть всегда предоставлено)
• Clipboard_API: clipboard-read, clipboard-write
• API вычислительной нагрузки: compute-pressure
• API геолокации: geolocation
• API доступа к локальным шрифтам: local-fonts
• API захвата медиа и потоков: microphone, camera
• API уведомлений: notifications
• API обработчика платежей: payment-handler
• API push-уведомлений: push
• API блокировки экрана: screen-wake-lock
• API датчиков: accelerometer, gyroscope, magnetometer, ambient-light-sensor
• API доступа к хранилищу: storage-access, top-level-storage-access
• API хранилища: persistent-storage
• API Bluetooth: bluetooth
• API MIDI: midi
• API управления окнами: window-management

Permissions

Предоставляет основную функциональность API разрешений, такие как методы для запроса и отмены разрешений.

PermissionStatus

Предоставляет доступ к текущему статусу разрешения и обработчику событий для реагирования на изменения статуса разрешения.

Navigator.permissions и WorkerNavigator.permissions Только чтение

Предоставляет доступ к объекту Permissions соответственно из основного контекста и контекста потока.

Мы создали пример под названием Поиск местоположения. Вы можете запустить пример онлайн, просмотреть исходный код на GitHub или узнать больше о его работе в нашей статье Использование API разрешений.

Пример Permissions.query() также показывает код, который тестирует большинство разрешений в текущем браузере и записывает результат.

• Использование API разрешений
• Использование API разрешений для определения частоты предоставления или отказа от доступа к камере
• Notification.permission
• Конфиденциальность, разрешения и безопасность информации