Machtigingen declareren

Om de meeste chrome.* API's te kunnen gebruiken, moet uw extensie of app de bedoeling ervan aangeven in het veld 'permissions' van het manifest . Elke toestemming kan een van een lijst met bekende tekenreeksen zijn (zoals 'geolocatie') of een overeenkomstpatroon dat toegang geeft tot een of meer hosts. Machtigingen helpen de schade te beperken als uw extensie of app wordt aangetast door malware. Sommige machtigingen worden vóór de installatie ook aan gebruikers weergegeven, zoals beschreven in Toestemmingswaarschuwingen .

Als een API vereist dat u toestemming geeft in het manifest, vertelt de documentatie hoe u dat moet doen. Op de pagina Opslag ziet u bijvoorbeeld hoe u de machtiging "opslag" kunt declareren.

Hier is een voorbeeld van het machtigingsgedeelte van een manifestbestand:

"permissions": [
  "tabs",
  "bookmarks",
  "http://www.blogger.com/",
  "http://*.google.com/",
  "unlimitedStorage"
],

De volgende tabel bevat de momenteel beschikbare machtigingen:

Toestemming Beschrijving
"activeTab" Verzoekt dat aan de extensie machtigingen worden verleend volgens de activeTab- specificatie.
"alarms" Geeft uw extensie toegang tot de chrome.alarms API.
"background"

Zorgt ervoor dat Chrome vroeg opstart en laat afsluit, zodat apps en extensies een langere levensduur hebben.

Wanneer een geïnstalleerde gehoste app, verpakte app of extensie 'achtergrond'-toestemming heeft, wordt Chrome (onzichtbaar) uitgevoerd zodra de gebruiker inlogt op zijn computer, voordat de gebruiker Chrome start. De 'achtergrond'-toestemming zorgt er ook voor dat Chrome blijft werken (zelfs nadat het laatste venster is gesloten) totdat de gebruiker Chrome expliciet afsluit.

Opmerking: Uitgeschakelde apps en extensies worden behandeld alsof ze niet zijn geïnstalleerd.

Normaal gesproken gebruikt u de toestemming "achtergrond" met een achtergrondpagina , evenementenpagina of (voor gehoste apps) een achtergrondvenster .

"bookmarks" Geeft uw extensie toegang tot de chrome.bookmarks API.
"browsingData" Geeft uw extensie toegang tot de chrome.browsingData API.
"certificateProvider" Geeft uw extensie toegang tot de chrome.certificateProvider API.
"clipboardRead" Vereist als de extensie of app document.execCommand('paste') gebruikt.
"clipboardWrite" Geeft aan dat de extensie of app document.execCommand('copy') of document.execCommand('cut') gebruikt. Deze toestemming is vereist voor gehoste apps ; het wordt aanbevolen voor extensies en verpakte apps.
"contentSettings" Geeft uw extensie toegang tot de chrome.contentSettings API.
"contextMenus" Geeft uw extensie toegang tot de chrome.contextMenus API.
"cookies" Geeft uw extensie toegang tot de chrome.cookies API.
"debugger" Geeft uw extensie toegang tot de chrome.debugger API.
"declarativeContent" Geeft uw extensie toegang tot de chrome.declarativeContent API.
"declarativeNetRequest" Geeft uw extensie toegang tot de chrome.declarativeNetRequest API.
"declarativeNetRequestFeedback" Verleent de extensie toegang tot gebeurtenissen en methoden binnen de chrome.declarativeNetRequest API die informatie retourneert over overeenkomende declaratieve regels.
"declarativeWebRequest" Geeft uw extensie toegang tot de chrome.declarativeWebRequest API.
"desktopCapture" Geeft uw extensie toegang tot de chrome.desktopCapture API.
"documentScan" Geeft uw extensie toegang tot de chrome.documentScan API.
"downloads" Geeft uw extensie toegang tot de chrome.downloads API.
"enterprise.deviceAttributes" Geeft uw extensie toegang tot de chrome.enterprise.deviceAttributes API.
"enterprise.hardwarePlatform" Geeft uw extensie toegang tot de chrome.enterprise.hardwarePlatform API.
"enterprise.networkingAttributes" Geeft uw extensie toegang tot de chrome.enterprise.networkingAttributes API.
"enterprise.platformKeys" Geeft uw extensie toegang tot de chrome.enterprise.platformKeys API.
"experimental" Vereist als de extensie of app gebruikmaakt van chrome.experimental.* API's .
"fileBrowserHandler" Geeft uw extensie toegang tot de chrome.fileBrowserHandler API.
"fileSystemProvider" Geeft uw extensie toegang tot de chrome.fileSystemProvider API.
"fontSettings" Geeft uw extensie toegang tot de chrome.fontSettings API.
"gcm" Geeft uw extensie toegang tot de chrome.gcm API.
"geolocation" Hiermee kan de extensie of app de geolocatie-API gebruiken zonder de gebruiker om toestemming te vragen.
"history" Geeft uw extensie toegang tot de chrome.history API.
"identity" Geeft uw extensie toegang tot de chrome.identity API.
"idle" Geeft uw extensie toegang tot de chrome.idle API.
"loginState" Geeft uw extensie toegang tot de chrome.loginState API.
"management" Geeft uw extensie toegang tot de chrome.management API.
"nativeMessaging" Geeft uw extensie toegang tot de native messaging-API .
"notifications" Geeft uw extensie toegang tot de chrome.notifications API.
"pageCapture" Geeft uw extensie toegang tot de chrome.pageCapture API.
"platformKeys" Geeft uw extensie toegang tot de chrome.platformKeys API.
"power" Geeft uw extensie toegang tot de chrome.power API.
"printerProvider" Geeft uw extensie toegang tot de chrome.printerProvider API.
"printing" Geeft uw extensie toegang tot de chrome.printing API.
"printingMetrics" Geeft uw extensie toegang tot de chrome.printingMetrics API.
"privacy" Geeft uw extensie toegang tot de chrome.privacy API.
"processes" Geeft uw extensie toegang tot de chrome.processes API.
"proxy" Geeft uw extensie toegang tot de chrome.proxy API.
"scripting" Geeft uw extensie toegang tot de chrome.scripting API.
"sessions" Geeft uw extensie toegang tot de chrome.sessions API.
"signedInDevices" Geeft uw extensie toegang tot de chrome.signedInDevices API.
"storage" Geeft uw extensie toegang tot de chrome.storage API.
"system.cpu" Geeft uw extensie toegang tot de chrome.system.cpu API.
"system.display" Geeft uw extensie toegang tot de chrome.system.display API.
"system.memory" Geeft uw extensie toegang tot de chrome.system.memory API.
"system.storage" Geeft uw extensie toegang tot de chrome.system.storage API.
"tabCapture" Geeft uw extensie toegang tot de chrome.tabCapture API.
"tabGroups" Geeft uw extensie toegang tot de chrome.tabGroups API.
"tabs" Geeft uw extensie toegang tot bevoorrechte velden van de Tab objecten die door verschillende API's worden gebruikt, waaronder chrome.tabs en chrome.windows . In veel gevallen hoeft uw extensie de "tabs" geen toestemming te geven om gebruik te maken van deze API's.
"topSites" Geeft uw extensie toegang tot de chrome.topSites API.
"tts" Geeft uw extensie toegang tot de chrome.tts API.
"ttsEngine" Geeft uw extensie toegang tot de chrome.ttsEngine API.
"unlimitedStorage" Biedt een onbeperkt quotum voor het opslaan van gegevens aan de clientzijde, zoals databases en lokale opslagbestanden. Zonder deze toestemming is de extensie of app beperkt tot 5 MB lokale opslag.
Opmerking: deze toestemming is alleen van toepassing op Web SQL Database en applicatiecache (zie uitgave 58985 ). Bovendien werkt het momenteel niet met subdomeinen met jokertekens, zoals http://*.example.com .
"vpnProvider" Geeft uw extensie toegang tot de chrome.vpnProvider API.
"wallpaper" Geeft uw extensie toegang tot de chrome.wallpaper API.
"webNavigation" Geeft uw extensie toegang tot de chrome.webNavigation API.
"webRequest" Geeft uw extensie toegang tot de chrome.webRequest API.
"webRequestBlocking" Vereist als de extensie de chrome.webRequest API op blokkerende wijze gebruikt.