Descrição
Use a API chrome.privacy
para controlar o uso dos recursos do Chrome que podem afetar a privacidade de um usuário. Essa API depende do protótipo ChromeSetting da API type para receber e definir a configuração do Chrome.
Permissões
privacy
Você precisa declarar a permissão "privacy" no manifesto da extensão para usar a API. Por exemplo:
{
"name": "My extension",
...
"permissions": [
"privacy"
],
...
}
Conceitos e uso
Ler o valor atual de uma configuração do Chrome é simples. Primeiro, encontre a propriedade de interesse. Depois, chame get()
nesse objeto para recuperar o valor atual e o nível de controle da extensão. Por exemplo, para determinar se o recurso de preenchimento automático de cartão de crédito do Chrome
está ativado, escreva:
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.value) {
console.log('Autofill is on!');
} else {
console.log('Autofill is off!');
}
});
Mudar o valor de uma configuração é um pouco mais complexo, porque primeiro você precisa verificar
se a extensão pode controlar a configuração. O usuário não vai notar nenhuma mudança nas configurações se a
extensão ativar uma configuração bloqueada para um valor específico por políticas corporativas
(levelOfControl
será definido como "not_controllable") ou se outra extensão estiver controlando o
valor (levelOfControl
será definido como "controlled_by_other_extensions"). A chamada set()
será concluída, mas a configuração será substituída imediatamente. Como isso pode ser confuso, é recomendável
avisar o usuário quando as configurações escolhidas não são aplicadas na prática.
Isso significa que você precisa usar o método get()
para determinar seu nível de acesso e só
chamar set()
se a extensão puder assumir o controle da configuração. Na verdade, se a extensão não puder
controlar a configuração, é recomendável desativar visualmente o recurso para reduzir a confusão do usuário.
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.levelOfControl === 'controllable_by_this_extension') {
chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
if (chrome.runtime.lastError === undefined) {
console.log("Hooray, it worked!");
} else {
console.log("Sadness!", chrome.runtime.lastError);
}
});
}
});
Se você quiser saber sobre mudanças no valor de uma configuração, adicione um listener ao evento onChange
dela. Entre outros usos, isso permite avisar o usuário se uma extensão instalada recentemente assumir o controle de uma configuração ou se a política corporativa substituir seu controle. Para detectar mudanças no
status do preenchimento automático de cartão de crédito, por exemplo, o código a seguir é suficiente:
chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
function (details) {
// The new value is stored in `details.value`, the new level of control
// in `details.levelOfControl`, and `details.incognitoSpecific` will be
// `true` if the value is specific to Incognito mode.
}
);
Exemplos
Para testar essa API, instale o exemplo de API de privacidade do repositório chrome-extension-samples.
Tipos
IPHandlingPolicy
A política de tratamento de IP do WebRTC.
Enumeração
"default"
"default_public_and_private_interfaces"
"default_public_interface_only"
"disable_non_proxied_udp"
Propriedades
network
Configurações que influenciam o processamento de conexões de rede pelo Chrome em geral.
Tipo
objeto
Propriedades
-
networkPredictionEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome tenta acelerar sua experiência de navegação na Web pré-resolvendo entradas de DNS e abrindo conexões TCP e SSL com servidores de forma preventiva. Essa preferência afeta apenas as ações realizadas pelo serviço de previsão interna do Chrome. Isso não afeta as pré-busca ou pré-conexões iniciadas por páginas da Web. O valor dessa preferência é um booleano, com o padrão
true
. -
webRTCIPHandlingPolicyChrome 48 ou mais recente
Permite que os usuários especifiquem as compensações de desempenho/privacidade de mídia, o que afeta como o tráfego do WebRTC será roteado e quanta informação de endereço local será exposta. O valor dessa preferência é do tipo IPHandlingPolicy, com o padrão
default
.
services
Configurações que ativam ou desativam recursos que exigem serviços de rede de terceiros fornecidos pelo Google e seu provedor de pesquisa padrão.
Tipo
objeto
Propriedades
-
alternateErrorPagesEnabled
types.ChromeSetting<boolean>
Se ativado, o Chrome usa um serviço da Web para ajudar a resolver erros de navegação. O valor dessa preferência é um booleano, com o padrão
true
. -
autofillAddressEnabled
types.ChromeSetting<boolean>
Chrome 70 ou mais recenteSe ativado, o Chrome oferece o preenchimento automático de endereços e outros dados de formulário. O valor dessa preferência é um booleano, com o padrão
true
. -
autofillCreditCardEnabled
types.ChromeSetting<boolean>
Chrome 70 ou mais recenteSe ativada, o Chrome oferece o preenchimento automático de formulários de cartão de crédito. O valor dessa preferência é um booleano, com o padrão
true
. -
autofillEnabled
types.ChromeSetting<boolean>
Suspensas desde o Chrome 70Use privacy.services.autofillAddressEnabled e privacy.services.autofillCreditCardEnabled. Isso permanece para compatibilidade com versões anteriores nesta versão e será removido no futuro.
Se ativado, o Chrome oferece o preenchimento automático de formulários. O valor dessa preferência é um booleano, com o padrão
true
. -
passwordSavingEnabled
types.ChromeSetting<boolean>
Se ativado, o gerenciador de senhas vai perguntar se você quer salvar senhas. O valor dessa preferência é um booleano, com o padrão
true
. -
safeBrowsingEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome faz o possível para proteger você contra phishing e malware. O valor dessa preferência é um booleano, com o padrão
true
. -
safeBrowsingExtendedReportingEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome vai enviar mais informações ao Google quando a Navegação segura bloquear uma página, como o conteúdo dela. O valor dessa preferência é um booleano, com o padrão
false
. -
searchSuggestEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome envia o texto digitado na omnibox para o mecanismo de pesquisa padrão, que fornece previsões de sites e pesquisas que provavelmente vão completar o que você digitou até agora. O valor dessa preferência é um booleano, com o padrão
true
. -
spellingServiceEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome usa um serviço da Web para ajudar a corrigir erros de ortografia. O valor dessa preferência é um booleano, com o padrão
false
. -
translationServiceEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome oferece a tradução de páginas que não estão em um idioma que você lê. O valor dessa preferência é um booleano, com o padrão
true
.
websites
Configurações que determinam quais informações o Chrome disponibiliza para os sites.
Tipo
objeto
Propriedades
-
adMeasurementEnabled
types.ChromeSetting<boolean>
Chrome 111+Se desativadas, a API Attribution Reporting e a API Private Aggregation serão desativadas. O valor dessa preferência é do tipo booleano, e o valor padrão é
true
. As extensões só podem desativar essas APIs definindo o valor comofalse
. Se você tentar definir essas APIs comotrue
, um erro será gerado. -
doNotTrackEnabled
types.ChromeSetting<boolean>
Chrome 65 ou mais recenteSe ativado, o Chrome envia o cabeçalho "Não rastrear" (
DNT: 1
) com suas solicitações. O valor dessa preferência é do tipo booleano, e o valor padrão éfalse
. -
fledgeEnabled
types.ChromeSetting<boolean>
Chrome 111+Se estiver desativada, a API Fledge será desativada. O valor dessa preferência é do tipo booleano, e o valor padrão é
true
. As extensões só podem desativar essa API definindo o valor comofalse
. Se você tentar definir essa API comotrue
, um erro será gerado. -
hyperlinkAuditingEnabled
types.ChromeSetting<boolean>
Se ativada, o Chrome envia pings de auditoria quando solicitado por um site (
<a ping>
). O valor dessa preferência é do tipo booleano, e o valor padrão étrue
. -
protectedContentEnabled
types.ChromeSetting<boolean>
Disponível apenas no Windows e no ChromeOS: se ativado, o Chrome fornece um ID exclusivo aos plug-ins para executar conteúdo protegido. O valor dessa preferência é do tipo booleano, e o valor padrão é
true
. -
referrersEnabled
types.ChromeSetting<boolean>
Se ativado, o Chrome enviará cabeçalhos
referer
com suas solicitações. Sim, o nome dessa preferência não corresponde ao cabeçalho com erro de ortografia. Não, não vamos mudar. O valor dessa preferência é do tipo booleano, e o valor padrão étrue
. -
types.ChromeSetting<boolean>
Chrome 121+Se desativada, a opção Conjuntos de sites relacionados será desativada. O valor dessa preferência é do tipo booleano, e o valor padrão é
true
. As extensões só podem desativar essa API definindo o valor comofalse
. Se você tentar definir essa API comotrue
, um erro será gerado. -
thirdPartyCookiesAllowed
types.ChromeSetting<boolean>
Se desativada, o Chrome impede que sites de terceiros definam cookies. O valor dessa preferência é do tipo booleano, e o valor padrão é
true
. As extensões não podem ativar essa API no modo de navegação anônima, em que os cookies de terceiros são bloqueados e só podem ser permitidos no nível do site. Se você tentar definir essa API como "true" no modo incógnito, um erro será gerado.Observação: sites individuais ainda podem acessar cookies de terceiros quando essa API retorna
false
, se tiverem uma exceção válida ou usarem a API Storage Access. -
topicsEnabled
types.ChromeSetting<boolean>
Chrome 111+Se estiver desativada, a API Topics será desativada. O valor dessa preferência é do tipo booleano, e o valor padrão é
true
. As extensões só podem desativar essa API definindo o valor comofalse
. Se você tentar definir essa API comotrue
, um erro será gerado.