optional_permissions
Type | Tableau |
---|---|
Obligatoire | Non |
Exemple |
json
|
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
"optional_permissions": ["*://developer.mozilla.org/*"]
Activez l'extension pour demander un accès privilégié aux pages sous developer.mozilla.org.
"optional_permissions": ["tabs"]
Activez l'extension pour demander l'accès aux éléments privilégiés de l'API des onglets.
"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