Rechten declareren

Als je de meeste chrome.*-API's wilt gebruiken, API's, moet je extensie of app de intentie definiëren in het veld permissions van het manifest. Elk recht kan een van de bekende tekenreeksen zijn (zoals 'geolocation') of een overeenkomstpatroon dat toegang geeft tot een of meer hosts. Rechten helpen de schade te beperken als je extensie of app wordt gehackt door malware. Sommige rechten worden ook vóór de installatie aan gebruikers getoond, zoals beschreven in Waarschuwingen voor rechten.

Als een API vereist dat je een recht declareert in het manifest, staat in de documentatie hoe je dit doet. Op de pagina Opslag staat bijvoorbeeld hoe je het recht Opslag declareert.

Hier volgt een voorbeeld van het gedeelte met rechten van een manifestbestand:

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

In de volgende tabel staan de momenteel beschikbare rechten:

Recht Beschrijving
"activeTab" Vraagt om de extensie rechten te geven volgens de specificatie activeTab.
"alarms" Geeft je extensie toegang tot de chrome.alarms API.
"background"

Zorgt dat Chrome vroeg opstart en laat afsluit, zodat apps en extensies langer kunnen worden gebruikt.

Als een geïnstalleerde gehoste app, verpakte app of extensie het recht 'background' heeft, wordt Chrome (onzichtbaar) uitgevoerd zodra de gebruiker inlogt op de computer, voordat de gebruiker Chrome start. Het recht background zorgt er ook voor dat Chrome actief blijft (zelfs nadat het laatste venster is gesloten) totdat de gebruiker Chrome expliciet afsluit.

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

Meestal gebruik je het recht 'background' met een achtergrondpagina, gebeurtenispagina of (voor gehoste apps) een achtergrondvenster.

"bookmarks" Geeft je extensie toegang tot de chrome.bookmarks API.
"browsingData" Geeft je extensie toegang tot de chrome.browsingData API.
"certificateProvider" Geeft je 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. Dit recht is vereist voor gehoste apps en wordt aanbevolen voor extensies en pakket-apps.
"contentSettings" Geeft je extensie toegang tot de chrome.contentSettings API.
"contextMenus" Geeft je extensie toegang tot de chrome.contextMenus API.
"cookies" Geeft je extensie toegang tot de chrome.cookies API.
"debugger" Geeft je extensie toegang tot de API chrome.debugger.
"declarativeContent" Geeft je extensie toegang tot de chrome.declarativeContent API.
"declarativeNetRequest" Geeft je extensie toegang tot de chrome.declarativeNetRequest API.
"declarativeNetRequestFeedback" Geeft de extensie toegang tot gebeurtenissen en methoden in de chrome.declarativeNetRequest API die informatie retourneren over overeenkomende declaratieve regels.
"declarativeWebRequest" Geeft je extensie toegang tot de chrome.declarativeWebRequest API.
"desktopCapture" Geeft je extensie toegang tot de chrome.desktopCapture API.
"documentScan" Geeft je extensie toegang tot de chrome.documentScan API.
"downloads" Geeft je extensie toegang tot de chrome.downloads API.
"enterprise.deviceAttributes" Geeft je extensie toegang tot de chrome.enterprise.deviceAttributes API.
"enterprise.hardwarePlatform" Geeft je extensie toegang tot de chrome.enterprise.hardwarePlatform API.
"enterprise.networkingAttributes" Geeft je extensie toegang tot de chrome.enterprise.networkingAttributes API.
"enterprise.platformKeys" Geeft je extensie toegang tot de chrome.enterprise.platformKeys API.
"experimental" Vereist als de extensie of app een chrome.experimental.* API's.
"fileBrowserHandler" Geeft je extensie toegang tot de chrome.fileBrowserHandler API.
"fileSystemProvider" Geeft je extensie toegang tot de chrome.fileSystemProvider API.
"fontSettings" Geeft je extensie toegang tot de chrome.fontSettings API.
"gcm" Geeft je extensie toegang tot de chrome.gcm API.
"geolocation" Hiermee kan de extensie of app de API voor geolocatie gebruiken zonder de gebruiker om toestemming te vragen.
"history" Geeft je extensie toegang tot de chrome.history API.
"identity" Geeft je extensie toegang tot de chrome.identity API.
"idle" Geeft je extensie toegang tot de chrome.idle API.
"loginState" Geeft je extensie toegang tot de chrome.loginState API.
"management" Geeft je extensie toegang tot de chrome.management API.
"nativeMessaging" Geeft je extensie toegang tot de native messaging API.
"notifications" Geeft je extensie toegang tot de chrome.notifications API.
"pageCapture" Geeft je extensie toegang tot de chrome.pageCapture API.
"platformKeys" Geeft je extensie toegang tot de chrome.platformKeys API.
"power" Geeft je extensie toegang tot de chrome.power API.
"printerProvider" Geeft je extensie toegang tot de chrome.printerProvider API.
"printing" Geeft je extensie toegang tot de chrome.printing API.
"printingMetrics" Geeft je extensie toegang tot de chrome.printingMetrics API.
"privacy" Geeft je extensie toegang tot de chrome.privacy API.
"processes" Geeft je extensie toegang tot de chrome.processes API.
"proxy" Geeft je extensie toegang tot de chrome.proxy API.
"scripting" Geeft je extensie toegang tot de chrome.scripting API.
"sessions" Geeft je extensie toegang tot de chrome.sessions API.
"signedInDevices" Geeft je extensie toegang tot de chrome.signedInDevices API.
"storage" Geeft je extensie toegang tot de chrome.storage API.
"system.cpu" Geeft je extensie toegang tot de chrome.system.cpu API.
"system.display" Geeft je extensie toegang tot de chrome.system.display API.
"system.memory" Geeft je extensie toegang tot de chrome.system.memory API.
"system.storage" Geeft je extensie toegang tot de chrome.system.storage API.
"tabCapture" Geeft je extensie toegang tot de chrome.tabCapture API.
"tabGroups" Geeft je extensie toegang tot de chrome.tabGroups API.
"tabs" Geeft je 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 je extensie het recht "tabs" niet te definiëren om deze API's te gebruiken.
"topSites" Geeft je extensie toegang tot de chrome.topSites API.
"tts" Geeft je extensie toegang tot de chrome.tts API.
"ttsEngine" Geeft je extensie toegang tot de chrome.ttsEngine API.
"unlimitedStorage" Biedt een onbeperkt quotum voor de opslag van gegevens aan de clientzijde, zoals databases en lokale opslagbestanden. Zonder dit recht is de extensie of app beperkt tot 5 MB lokale opslag.
Opmerking: Dit recht is alleen van toepassing op Web SQL Database en app-cache (zie probleem 58985). De functie werkt op dit moment ook niet met wildcard-subdomeinen zoals http://*.example.com.
"vpnProvider" Geeft je extensie toegang tot de chrome.vpnProvider API.
"webNavigation" Geeft je extensie toegang tot de chrome.webNavigation API.
"webRequest" Geeft je extensie toegang tot de chrome.webRequest API.
"webRequestBlocking" Vereist als de extensie de chrome.webRequest API op een blokkerende manier gebruikt.