As extensões do Manifest V2 foram removidas da Chrome Web Store em 31 de agosto de 2026. Migre sua extensão para o Manifest V3 para que ela fique disponível para os usuários novamente.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

chrome.privacy

refresh date: 2026-09-25 robots: noindex

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 da API de tipo para receber e definir a configuração do Chrome.

Permissões

privacy

Manifesto

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

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

Uso

Ler o valor atual de uma configuração do Chrome é simples. Primeiro, você precisa encontrar a propriedade em que tem 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 do Chrome está ativado, escreva:

chrome.privacy.services.autofillEnabled.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 é preciso 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 alternar uma configuração que esteja 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á bem-sucedida, 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 forem aplicadas na prática.

Observação: todos os detalhes sobre a capacidade das extensões de controlar ChromeSettings podem ser encontrados em chrome.types.ChromeSetting.

Isso significa que você deve usar o método get() para determinar seu nível de acesso e, em seguida, chamar set() apenas se a extensão puder controlar a configuração. Na verdade, se a extensão não puder controlar a configuração, é recomendável desativar visualmente a funcionalidade para reduzir a confusão do usuário:

chrome.privacy.services.autofillEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillEnabled.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 as 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 do preenchimento automático, por exemplo, o código a seguir seria suficiente:

chrome.privacy.services.autofillEnabled.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

AutofillBlockedType

Chrome 151+

Categorias de dados de preenchimento automático.

Enumeração

"contact_info"

"payments"

"identity_docs"

"viagem"

"all"

IPHandlingPolicy

Chrome 48 ou mais recente

A política de processamento de IPs 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, abrindo conexões TCP e SSL com servidores de forma preventiva e pré-carregando páginas. Desativar essa preferência substitui a capacidade dos proprietários de sites de carregar conteúdo de forma especulativa (como pré-busca ou pré-renderização usando a API Speculation Rules). Isso não afeta as pré-conexões ou pré-buscas de DNS iniciadas pela página da Web. O valor dessa preferência é um booleano, com o padrão true.
webRTCIPHandlingPolicy

types.ChromeSetting<IPHandlingPolicy>

Chrome 48 ou mais recente

Permite que os usuários especifiquem as compensações de desempenho/privacidade de mídia que afetam como o tráfego do WebRTC será roteado e quantas informações de endereço local serão expostas. 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 pelo seu provedor de pesquisa padrão.

Tipo

objeto

Propriedades

alternateErrorPagesEnabled

types.ChromeSetting<boolean>

Se essa política for ativada, o Chrome vai usar 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 recente

Se ativada, o Chrome oferece o preenchimento automático de endereços e outros dados de formulários. O valor dessa preferência é um booleano, com o padrão true.
autofillCreditCardEnabled

types.ChromeSetting<boolean>

Chrome 70 ou mais recente

Se 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>

Descontinuado 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 ativada, 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 as 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 seu mecanismo de pesquisa padrão, que fornece previsões de sites e pesquisas que provavelmente completam o que você digitou até o momento. O valor dessa preferência é um booleano, com o padrão true.
spellingServiceEnabled

types.ChromeSetting<boolean>

Se ativada, o Chrome vai usar 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 desativada, as APIs Attribution Reporting e 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 como false. Se você tentar definir essas APIs como true, um erro será gerado.
doNotTrackEnabled

types.ChromeSetting<boolean>

Chrome 65 ou mais recente

Se ativada, o Chrome envia o cabeçalho "Do Not Track" (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 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 ativada, 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 vai 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.
thirdPartyCookiesAllowed

types.ChromeSetting<boolean>

Se ela for desativada, o Chrome vai impedir 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 verdadeira no modo de navegação anônima, um erro será gerado.

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

types.ChromeSetting<boolean>

Chrome 111+

Se desativada, a API Topics é 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.

chrome.privacy Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Descrição

Permissões

Manifesto

Uso

Exemplos

Tipos

AutofillBlockedType

Enumeração

IPHandlingPolicy

Enumeração

Propriedades

network

Tipo

Propriedades

services

Tipo

Propriedades

websites

Tipo

Propriedades

chrome.privacy