chrome.privacy

Descrição

Use a API chrome.privacy para controlar o uso dos recursos do Chrome que podem afetar a privacidade do usuário. Essa API depende do protótipo ChromeSetting do tipo API para receber e definir a configuração do Chrome.

Permissões

privacy

É necessário declarar a permissão "privacidade" no manifesto da sua extensão para usar a API. Por exemplo:

{
  "name": "My extension",
  ...
  "permissions": [
    "privacy"
  ],
  ...
}

Conceitos e uso

A leitura do valor atual de uma configuração do Chrome é simples. Primeiro, você precisa encontrar a propriedade de seu interesse e, em seguida, chamar 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, você escreve:

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 é necessário 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 em 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() terá sucesso, mas a configuração será substituída imediatamente. Como isso pode ser confuso, é recomendável alertar o usuário quando as configurações escolhidas não forem aplicadas.

Isso significa que você precisa usar o método get() para determinar seu nível de acesso e, em seguida, chamar set() apenas 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ê tiver interesse em mudanças no valor de uma configuração, adicione um listener ao evento onChange dela. Entre outros usos, isso permite que você avise o usuário se uma extensão instalada mais recentemente assumir o controle de uma configuração ou se a política corporativa substituir seu controle. Para detectar mudanças no status de 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

Chrome 48 e versões mais recentes

A política de processamento de IPs do WebRTC.

Enumeração

"padrão"

"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 do Chrome em geral.

Tipo

objeto

Propriedades

  • networkPredictionEnabled

    types.ChromeSetting<boolean>

    Se ativada, o Chrome tenta acelerar sua experiência de navegação na Web resolvendo previamente as entradas de DNS e abrindo preventivamente conexões TCP e SSL para servidores. Essa preferência só afeta as ações realizadas pelo serviço de previsão interno do Chrome. Isso não afeta as previsões ou as pré-conexões iniciadas pela página da Web. O valor dessa preferência é um booleano, com padrão true.

  • webRTCIPHandlingPolicy

    types.ChromeSetting<IPHandlingPolicy>

    Chrome 48 e versões mais recentes

    Permitir que os usuários especifiquem as compensações de desempenho/privacidade da mídia, o que afeta como o tráfego do WebRTC será roteado e a quantidade de informações de endereço local expostas. O valor dessa preferência é do tipo IPHandlingPolicy, com padrão default.

services

Configurações que ativam ou desativam recursos que exigem serviços de rede de terceiros fornecidos pelo Google e pelo seu provedor de pesquisa padrão.

Tipo

objeto

Propriedades

  • alternateErrorPagesEnabled

    types.ChromeSetting<boolean>

    Se ativada, o Chrome usa um serviço da Web para ajudar a resolver erros de navegação. O valor dessa preferência é um booleano, com padrão true.

  • autofillAddressEnabled

    types.ChromeSetting<boolean>

    Chrome 70 ou mais recente

    Se estiver ativado, o Chrome vai oferecer a opção de preencher automaticamente endereços e outros dados de formulário. O valor dessa preferência é um booleano, com padrão true.

  • autofillCreditCardEnabled

    types.ChromeSetting<boolean>

    Chrome 70 ou mais recente

    Se ativado, o Chrome oferece a opção de preencher formulários de cartão de crédito automaticamente. O valor dessa preferência é um booleano, com padrão true.

  • autofillEnabled

    types.ChromeSetting<boolean>

    Suspensa desde o Chrome 70

    Use privacy.services.autofillAddressEnabled e privacy.services.autofillCreditCardEnabled. Isso permanece para compatibilidade com versões anteriores nesta versão e será removido no futuro.

    Se estiver ativado, o Chrome vai oferecer a opção de preencher formulários automaticamente. O valor dessa preferência é um booleano, com padrão true.

  • passwordSavingEnabled

    types.ChromeSetting<boolean>

    Se estiver ativado, o gerenciador de senhas vai perguntar se você quer salvar as senhas. O valor dessa preferência é um booleano, com 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 padrão true.

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting<boolean>

    Se ativado, o Chrome vai enviar mais informações ao Google quando a Navegação segura bloquear uma página, como o conteúdo da página bloqueada. O valor dessa preferência é um booleano, com 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 oferece previsões de sites e pesquisas que provavelmente são conclusões do que você digitou até agora. O valor dessa preferência é um booleano, com 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 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ê conhece. O valor dessa preferência é um booleano, com 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 e versões mais recentes

    Se desativado, a API Attribution Reporting e a API Private Aggregation sã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 como false. Se você tentar definir essas APIs como true, um erro será gerado.

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

    Chrome 65 e versões mais recentes

    Se 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 e versões mais recentes

    Se desativada, a API Fledge é 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 como false. Se você tentar definir essa API como true, 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 ativada, o Chrome envia cabeçalhos referer com suas solicitações. Sim, o nome dessa preferência não corresponde ao cabeçalho com erro ortográfico. Não, não vamos mudar. O valor dessa preferência é do tipo booleano, e o valor padrão é true.

  • relatedWebsiteSetsEnabled

    types.ChromeSetting<boolean>

    Chrome 121 e versões mais recentes

    Se desativado, o recurso Conjuntos de sites relacionados será desativado. 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 como false. Se você tentar definir essa API como true, um erro será gerado.

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

    Se desativado, o Chrome impede que sites de terceiros definam cookies. O valor dessa preferência é do tipo booleano, e o valor padrão é true.

    **Observação:**sites individuais ainda podem acessar cookies de terceiros quando essa API retorna false, se tiverem uma isenção válida ou se usarem a API Storage Access.

  • topicsEnabled

    types.ChromeSetting<boolean>

    Chrome 111 e versões mais recentes

    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 como false. Se você tentar definir essa API como true, um erro será gerado.