Declarar permissões de API no manifesto

Para usar a chrome.*permissions maioria das APIs, sua extensão deve declarar sua intenção nos campos do manifesto. Uma extensão pode declarar permissões usando uma cadeia de caracteres de permissão da tabela a seguir ou usar um padrão para corresponder a cadeias de caracteres semelhantes. As permissões ajudam a restringir sua extensão se ela for comprometida por malware. Algumas permissões são exibidas aos usuários para que tenham dado o consentimento antes da instalação da extensão ou em tempo de execução, conforme necessário. estes são avisos de permissão.

Se uma API exigir que você declare permissões no manifesto, consulte a documentação dessa API para entender as permissões necessárias. Por exemplo, a página da API de Armazenamento descreve como declarar a storage permissão.

Veja um exemplo da parte de permissões de um arquivo de manifesto:

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

A tabela a seguir lista as cadeias de caracteres de permissão disponíveis no momento a serem usadas no manifesto e as descrições.

Cadeia de caracteres de permissão Detalhes
activeTab Solicita que a extensão receba permissões de acordo com a activeTab especificação.
alarms Dá acesso à sua extensão à chrome.alarms API.
background Faz com que o Microsoft Edge seja iniciado mais cedo e desligado tarde, para que as extensões possam ter uma vida útil mais longa.
Quando qualquer extensão instalada tem permissão, o Microsoft Edge é background executado de forma invisível assim que o usuário faz logon no computador do usuário e antes que o usuário inicie o Microsoft Edge. A background permissão também faz com que o Microsoft Edge continue em execução, mesmo depois que sua última janela for fechada, até que o usuário saia explicitamente do Microsoft Edge.
As extensões desabilitadas são tratadas como se não estivessem instaladas.
Você deve usar a permissão com trabalhadores de background serviço; consulte Sobre trabalhadores de serviço de extensão em developer.chrome.com.
bookmarks Dá acesso à sua extensão à chrome.bookmarks API.
browsingData Dá acesso à sua extensão à chrome.browsingData API.
certificateProvider Dá acesso à sua extensão à chrome.certificateProvider API.
clipboardRead Obrigatório se a extensão usar document.execCommand('paste').
clipboardWrite Indica que a extensão usa document.execCommand('copy') ou document.execCommand('cut').
contentSettings Dá acesso à sua extensão à chrome.contentSettings API.
contextMenus Dá acesso à sua extensão à chrome.contextMenus API.
cookies Dá acesso à sua extensão à chrome.cookies API.
debugger Dá acesso à sua extensão à chrome.debugger API.
declarativeContent Dá acesso à sua extensão à chrome.declarativeContent API.
declarativeNetRequest Dá acesso à sua extensão à chrome.declarativeNetRequest API. Permite que a extensão bloqueie e atualize solicitações sem exigir permissões de host, mas requer permissões de host para redirecionar solicitações ou modificar cabeçalhos.
declarativeNetRequestWithHostAccess Dá acesso à sua extensão à chrome.declarativeNetRequest API. Sempre requer permissões de host na URL da solicitação e no iniciador, para agir na solicitação.
declarativeNetRequestFeedback Concede à extensão acesso a eventos e métodos na chrome.declarativeNetRequest API, que retorna informações sobre regras declarativas correspondentes.
declarativeWebRequest Dá acesso à sua extensão à chrome.declarativeWebRequest API.
desktopCapture Dá acesso à sua extensão à chrome.desktopCapture API.
documentScan Dá acesso à sua extensão à chrome.documentScan API.
downloads Dá acesso à sua extensão à chrome.downloads API.
enterprise.deviceAttributes Dá acesso à sua extensão à chrome.enterprise.deviceAttributes API.
enterprise.hardwarePlatform Dá acesso à sua extensão à chrome.enterprise.hardwarePlatform API.
enterprise.networkingAttributes Dá acesso à sua extensão à chrome.enterprise.networkingAttributes API.
enterprise.platformKeys Dá acesso à sua extensão à chrome.enterprise.platformKeys API.
experimental Obrigatório se a extensão usar qualquer chrome.experimental.* API.
fileBrowserHandler Dá acesso à sua extensão à chrome.fileBrowserHandler API.
fileSystemProvider Dá acesso à sua extensão à chrome.fileSystemProvider API.
fontSettings Dá acesso à sua extensão à chrome.fontSettings API.
geolocation Permite que a extensão use a API de geolocalização sem solicitar permissão ao usuário.
history Dá acesso à sua extensão à chrome.history API.
identity Dá acesso à sua extensão à chrome.identity API.
idle Dá acesso à sua extensão à chrome.idle API.
loginState Dá acesso à sua extensão à chrome.loginState API.
management Dá acesso à sua extensão à chrome.management API.
nativeMessaging Dá à sua extensão acesso à API de mensagens nativa.
notifications Dá acesso à sua extensão à chrome.notifications API.
pageCapture Dá acesso à sua extensão à chrome.pageCapture API.
platformKeys Dá acesso à sua extensão à chrome.platformKeys API.
power Dá acesso à sua extensão à chrome.power API.
printerProvider Dá acesso à sua extensão à chrome.printerProvider API.
printing Dá acesso à sua extensão à chrome.printing API.
printingMetrics Dá acesso à sua extensão à chrome.printingMetrics API.
privacy Dá acesso à sua extensão à chrome.privacy API.
processes Dá acesso à sua extensão à chrome.processes API.
proxy Dá acesso à sua extensão à chrome.proxy API.
scripting Dá acesso à sua extensão à chrome.scripting API.
search Dá acesso à sua extensão à chrome.search API.
sessions Dá acesso à sua extensão à chrome.sessions API.
sidePanel Dá acesso à sua extensão à chrome.sidePanel API. Consulte Desenvolver uma extensão para a barra lateral do Microsoft Edge.
signedInDevices Dá acesso à sua extensão à chrome.signedInDevices API.
storage Dá acesso à sua extensão à chrome.storage API.
system.cpu Dá acesso à sua extensão à chrome.system.cpu API.
system.display Dá acesso à sua extensão à chrome.system.display API.
system.memory Dá acesso à sua extensão à chrome.system.memory API.
system.storage Dá acesso à sua extensão à chrome.system.storage API.
tabCapture Dá acesso à sua extensão à chrome.tabCapture API.
tabGroups Dá acesso à sua extensão à chrome.tabGroups API.
tabs Dá à sua extensão acesso a campos privilegiados dos objetos Tab que podem ser usados por várias APIs, incluindo chrome.tabs e chrome.windows. Em muitas circunstâncias, sua extensão não precisa declarar a tabs permissão para usar essas APIs.
topSites Dá acesso à sua extensão à chrome.topSites API.
tts Dá acesso à sua extensão à chrome.tts API.
ttsEngine Dá acesso à sua extensão à chrome.ttsEngine API.
unlimitedStorage Fornece uma cota ilimitada para armazenar dados do lado do cliente, como bancos de dados e arquivos de armazenamento local. Sem essa permissão, a extensão é limitada a 5 MB de armazenamento local.
Essa permissão se aplica apenas ao Banco de Dados SQL Web e ao cache do aplicativo (consulte o Problema 58985: a permissão de Armazenamento Ilimitado deve ser aplicada ao Armazenamento Local).
No momento, essa permissão não funciona com subdomínios curinga, como http://*.contoso.com.
vpnProvider Dá acesso à sua extensão à chrome.vpnProvider API.
wallpaper Dá acesso à sua extensão à chrome.wallpaper API.
webNavigation Dá acesso à sua extensão à chrome.webNavigation API.
webRequest Dá acesso à sua extensão à chrome.webRequest API.
webRequestBlocking Obrigatório se a extensão usar a chrome.webRequest API para bloquear solicitações.

Observação

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Google e usadas de acordo com os termos descritos na Licença Creative Commons Atribuição 4.0 Internacional. A página original é encontrada aqui.

Licença Creative Commons Este trabalho está licenciado sob uma Licença Creative Commons Atribuição 4.0 Internacional.

Confira também

  • Last updated on