optional_permissions

Type Tableau
Obligatoire Non
Exemple
json
"optional_permissions": [
  "*://developer.mozilla.org/*",
  "webRequest"
]

Utilisez la clé optional_permissions pour lister les permissions que vous souhaitez demander pour l'exécution, une fois que votre extension a été installée.

La clé de permissions énumère les permissions dont votre extension a besoin si elle doit être installée. En revanche , optional_permissions liste les permissions dont votre extension n'a pas besoin au moment de l'installation, mais qu'il peut être nécessaire de demander pour l'exécution à un moment donné après son installation. Pour demander une permission, utilisez l'API permissions . La demande de permission peut présenter probablement à l'utilisateur une boîte de dialogue lui demandant d'accorder la permission à votre extension.

Pour des conseils sur la conception de votre demande d'autorisations d'exécution, afin de maximiser la probabilité que les utilisateurs les accordent, consultez la section, voir Demander les permissions à éxécuter.

La clé peut contenir deux types d'autorisations: les permissions d'hôte et les permissions d'API

Permissions d'hôte

Ce sont les mêmes que les permissions d'hôte que vous pouvez spécifier dans la clé permissions.

Permissions d'API

Vous pouvez inclure l'un des éléments suivants ici, mais pas dans tous les navigateurs : consultez la table de compatibilité pour obtenir des détails spécifiques au navigateur :

  • activeTab
  • background
  • bookmarks
  • browserSettings
  • clipboardRead
  • clipboardWrite
  • contentSettings
  • contextMenus
  • cookies
  • debugger
  • downloads
  • downloads.open
  • find
  • geolocation
  • history
  • idle
  • management
  • notifications
  • pageCapture
  • privacy
  • tabHide
  • tabs
  • topSites
  • webNavigation
  • webRequest
  • webRequestBlocking

Notez qu'il s'agit d'un sous-ensemble des permissions API permises dans les permissions.

Dans cet ensemble, les permissions suivantes sont accordées en silence, sans invite de l'utilisateur : activeTab, cookies, idle, webRequest, webRequestBlocking.

Exemple

json
 "optional_permissions": ["*://developer.mozilla.org/*"]

Activez l'extension pour demander un accès privilégié aux pages sous developer.mozilla.org.

json
  "optional_permissions": ["tabs"]

Activez l'extension pour demander l'accès aux éléments privilégiés de l'API des onglets.

json
  "optional_permissions": ["*://developer.mozilla.org/*", "tabs"]

Activez l'extension pour demander les deux permissions ci-dessus.

Compatibilité des navigateurs

BCD tables only load in the browser