Разрешения

Позволяет расширениям запрашивать дополнительные разрешения во время выполнения после их установки.

Расширениям необходимы разрешения для доступа к более мощным API WebExtension. Они могут запросить разрешения во время установки, включив необходимые разрешения в ключе permissions файла manifest.json. Основные преимущества запроса разрешений во время установки:

• Пользователь будет спрашиваться только один раз, что менее дискомфортно и упрощает принятие решения.
• Расширение может полагаться на доступ к необходимым API, так как если оно уже запущено, разрешения были предоставлены.

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

С помощью API разрешений расширение может запросить дополнительные разрешения во время выполнения. Эти разрешения должны быть перечислены в ключе optional_permissions файла manifest.json. Обратите внимание, что некоторые разрешения не разрешены в optional_permissions. Основные преимущества этого:

• Расширение может работать с меньшим набором разрешений, за исключением случаев, когда они действительно нужны.
• Расширение может обрабатывать отказ в предоставлении разрешений более изящно, вместо того, чтобы предлагать пользователю глобальный выбор «все или ничего» во время установки. Вы все еще можете получить много от расширения карты, не предоставляя ему доступ к вашему местоположению, например.
• Расширение может потребовать разрешений на хост, но не знать во время установки, какие разрешения на хост ему нужны. Например, список хостов может быть настройкой пользователя. В этом случае запрос более конкретного диапазона хостов во время выполнения может быть альтернативой запросу «<all_urls>» во время установки.

Для использования API разрешений определите, какие разрешения ваше расширение может запросить во время выполнения, и перечислите их в optional_permissions. После этого вы можете запросить любые разрешения, которые были включены в optional_permissions. Запросы могут выполняться только в обработчике действия пользователя (например, обработчике щелчка).

Начиная с Firefox 84, пользователи смогут управлять дополнительными разрешениями установленных расширений из менеджера дополнений. Расширения, использующие дополнительные разрешения, должны прослушивать события API browser.permissions.onAdded и browser.permissions.onRemoved для того, чтобы знать, когда пользователь предоставляет или отменяет эти разрешения.

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