Pour utiliser la plupart des appareils Chrome*. API, votre extension ou application doit déclarer son intent dans la section "autorisations" champ du fichier manifeste. Chaque autorisation peut faire partie d'une liste de chaînes connues (comme "géolocalisation") ou un modèle de correspondance qui donne accès à un ou plusieurs hôtes. Les autorisations permettent de limiter les dommages si votre extension ou application est compromise par un logiciel malveillant. Certaines autorisations sont également affichées aux utilisateurs avant l'installation, comme indiqué dans la section Avertissements concernant les autorisations.
Si une API vous oblige à déclarer une autorisation dans le fichier manifeste, sa documentation vous indique pour ce faire. Par exemple, la page Stockage vous montre comment déclarer l'espace de stockage. l'autorisation.
Voici un exemple de partie "autorisations" d'un fichier manifeste:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
Le tableau suivant répertorie les autorisations actuellement disponibles:
| Autorisation | Description |
|---|---|
"activeTab" |
Demande à l'extension d'obtenir des autorisations conformément à activeTab. spécifique. |
"alarms" |
Accorde à votre extension l'accès à l'API chrome.alarms. |
"background" |
Chrome démarre de manière anticipée et s'arrête tardivement, ce qui permet aux applications et aux extensions de bénéficier d'une vie. Lorsqu'une application hébergée, une application empaquetée ou une extension installée possède un "arrière-plan" autorisation, Chrome exécute (de manière invisible) dès que l'utilisateur se connecte à son ordinateur, avant qu'il ne lance Chrome. L'"arrière-plan" permet également à Chrome de continuer à s'exécuter (même après la fermeture de sa dernière fenêtre) jusqu'à ce que l'utilisateur ferme Chrome. Remarque:Les applications et extensions désactivées sont traitées comme si elles n'étaient pas
installés.
Vous utilisez généralement l'« arrière-plan » l'autorisation avec une page en arrière-plan, une page d'événement ou (pour les applications hébergées) une fenêtre d'arrière-plan. |
"bookmarks" |
Permet à votre extension d'accéder à l'API chrome.bookmarks. |
"browsingData" |
Permet à votre extension d'accéder à l'API chrome.browsingData. |
"certificateProvider" |
Accorde à votre extension l'accès à l'API chrome.certificateProvider. |
"clipboardRead" |
Obligatoire si l'extension ou l'application utilise document.execCommand('paste'). |
"clipboardWrite" |
Indique que l'extension ou l'application utilise document.execCommand('copy') ou
document.execCommand('cut') Cette autorisation est requise pour les applications hébergées. c'est recommandé
pour les extensions et les applications empaquetées. |
"contentSettings" |
Permet à votre extension d'accéder à l'API chrome.contentSettings. |
"contextMenus" |
Permet à votre extension d'accéder à l'API chrome.contextMenus. |
"cookies" |
Autorise votre extension à accéder à l'API chrome.cookies. |
"debugger" |
Accorde à votre extension l'accès à l'API chrome.debugger. |
"declarativeContent" |
Accorde à votre extension l'accès à l'API chrome.declarativeContent. |
"declarativeNetRequest" |
Accorde à votre extension l'accès à l'API chrome.declarativeNetRequest. |
"declarativeNetRequestFeedback" |
Accorde à l'extension l'accès aux événements et aux méthodes de l'API chrome.declarativeNetRequest qui renvoient des informations sur les ou règles correspondantes. |
"declarativeWebRequest" |
Accorde à votre extension l'accès à l'API chrome.declarativeWebRequest. |
"desktopCapture" |
Permet à votre extension d'accéder à l'API chrome.desktopCapture. |
"documentScan" |
Accorde à votre extension l'accès à l'API chrome.documentScan. |
"downloads" |
Permet à votre extension d'accéder à l'API chrome.downloads. |
"enterprise.deviceAttributes" |
Permet à votre extension d'accéder à l'API chrome.enterprise.deviceAttributes. |
"enterprise.hardwarePlatform" |
Permet à votre extension d'accéder à l'API chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
Permet à votre extension d'accéder à l'API chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
Permet à votre extension d'accéder à l'API chrome.enterprise.platformKeys. |
"experimental" |
Obligatoire si l'extension ou l'application utilise une extension chrome.experimental.* API. |
"fileBrowserHandler" |
Permet à votre extension d'accéder à l'API chrome.fileBrowserHandler. |
"fileSystemProvider" |
Accorde à votre extension l'accès à l'API chrome.fileSystemProvider. |
"fontSettings" |
Autorise votre extension à accéder à l'API chrome.fontSettings. |
"gcm" |
Autorise votre extension à accéder à l'API chrome.gcm. |
"geolocation" |
Autorise l'extension ou l'application à utiliser l'API de géolocalisation sans demander à l'utilisateur de saisir l'autorisation. |
"history" |
Permet à votre extension d'accéder à l'API chrome.history. |
"identity" |
Accorde à votre extension l'accès à l'API chrome.identity. |
"idle" |
Accorde à votre extension l'accès à l'API chrome.idle. |
"loginState" |
Accorde à votre extension l'accès à l'API chrome.loginState. |
"management" |
Accorde à votre extension l'accès à l'API chrome.management. |
"nativeMessaging" |
Accorde à votre extension l'accès à l'API de messagerie native. |
"notifications" |
Permet à votre extension d'accéder à l'API chrome.notifications. |
"pageCapture" |
Permet à votre extension d'accéder à l'API chrome.pageCapture. |
"platformKeys" |
Permet à votre extension d'accéder à l'API chrome.platformKeys. |
"power" |
Permet à votre extension d'accéder à l'API chrome.power. |
"printerProvider" |
Accorde à votre extension l'accès à l'API chrome.printerProvider. |
"printing" |
Permet à votre extension d'accéder à l'API chrome.printing. |
"printingMetrics" |
Permet à votre extension d'accéder à l'API chrome.printingMetrics. |
"privacy" |
Autorise votre extension à accéder à l'API chrome.privacy. |
"processes" |
Permet à votre extension d'accéder à l'API chrome.processes. |
"proxy" |
Accorde à votre extension l'accès à l'API chrome.proxy. |
"scripting" |
Accorde à votre extension l'accès à l'API chrome.scripting. |
"search" |
Permet à votre extension d'accéder à l'API chrome.search. |
"sessions" |
Permet à votre extension d'accéder à l'API chrome.sessions. |
"signedInDevices" |
Accorde à votre extension l'accès à l'API chrome.signedInDevices. |
"storage" |
Permet à votre extension d'accéder à l'API chrome.storage. |
"system.cpu" |
Accorde à votre extension l'accès à l'API chrome.system.cpu. |
"system.display" |
Permet à votre extension d'accéder à l'API chrome.system.display. |
"system.memory" |
Permet à votre extension d'accéder à l'API chrome.system.memory. |
"system.storage" |
Permet à votre extension d'accéder à l'API chrome.system.storage. |
"tabCapture" |
Accorde à votre extension l'accès à l'API chrome.tabCapture. |
"tabGroups" |
Permet à votre extension d'accéder à l'API chrome.tabGroups. |
"tabs" |
Accorde à votre extension l'accès aux champs privilégiés des objets Tab utilisés par plusieurs API
y compris chrome.tabs et chrome.windows. Dans
dans de nombreux cas, votre extension n'aura pas besoin de déclarer l'autorisation "tabs" pour utiliser
ces API. |
"topSites" |
Permet à votre extension d'accéder à l'API chrome.topSites. |
"tts" |
Accorde à votre extension l'accès à l'API chrome.tts. |
"ttsEngine" |
Accorde à votre extension l'accès à l'API chrome.ttsEngine. |
"unlimitedStorage" |
Fournit un quota illimité pour le stockage des données côté client, telles que les bases de données et les fichiers de stockage local.
Sans cette autorisation, l'espace de stockage local de l'extension ou de l'application est limité à 5 Mo. Remarque:Cette autorisation ne s'applique qu'à la base de données Web SQL et au cache de l'application.
(consultez le problème 58985). De plus, il ne fonctionne pas avec les caractères génériques
des sous-domaines tels que
http://*.example.com. |
"vpnProvider" |
Accorde à votre extension l'accès à l'API chrome.vpnProvider. |
"wallpaper" |
Permet à votre extension d'accéder à l'API chrome.wallpaper. |
"webNavigation" |
Permet à votre extension d'accéder à l'API chrome.webNavigation. |
"webRequest" |
Accorde à votre extension l'accès à l'API chrome.webRequest. |
"webRequestBlocking" |
Obligatoire si l'extension utilise l'API chrome.webRequest de manière bloquante. |